Microsoft DirectX 8.0 (C++)

DSBPOSITIONNOTIFY

通知位置を記述する。IDirectSoundNotify8::SetNotificationPositions メソッドで使われる。

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

メンバ

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

注意

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

DSBCAPS_LOCDEFER および DSBCAPS_NOTIFY をボイス管理フラグと共に使うと、通知が設定されているが、まだ通知に達していないサウンドは、ボイス管理によって終了される場合がある。この場合、通知イベントは発生しない。

動作環境

  ヘッダー : dsound.h で宣言。