Platform SDK: DirectX

DSBPOSITIONNOTIFY

DSBPOSITIONNOTIFY 構造体は、IDirectSoundNotify::SetNotificationPositions メソッドによって使われる。

typedef struct {
    DWORD   dwOffset;
    HANDLE  hEventNotify;
} DSBPOSITIONNOTIFY, *LPDSBPOSITIONNOTIFY;
 
typedef const DSBPOSITIONNOTIFY *LPCDSBPOSITIONNOTIFY;

メンバ

dwOffset
バッファの先頭から、通知イベントがトリガされる場所までのオフセット、または DSBPN_OFFSETSTOP。
hEventNotify
指定のオフセットに達したときにシグナル送信されるイベントへのハンドル。

注意

dwOffset メンバ内で値 DSBPN_OFFSETSTOP が設定されている場合、再生またはキャプチャがバッファの最後に達した (そして再生またはキャプチャがループしていない) か、アプリケーションが IDirectSoundBuffer::Stop または IDirectSoundCaptureBuffer::Stop のどちらかのメソッドを呼び出したことが原因で、再生またはキャプチャが停止すると、イベントがシグナル送信される。

注 :  ボイス管理の TERMINATEBY フラグと共に LOC_DEFER と NOTIFY を使用している場合、まだ到達せず、通知設定を保持するサウンドは、ボイス管理によって終了されることもある。この場合、通知イベントは発生しない。

動作環境

  Windows NT/2000 : Service Pack 3 を適用した Windows NT バージョン 4.0 以降が必要。
  Windows 95/98 : Windows 95 以降が必要。Windows 95 用に再配布可能な形で使用可能。
  ヘッダー : dsound.h で宣言。