DSBPOSITIONNOTIFY

DSBPOSITIONNOTIFY 構造体は通知位置を表します。これは、IDirectSoundNotify8::SetNotificationPositions により使用されます。

typedef struct DSBPOSITIONNOTIFY {
    DWORD dwOffset;
    HANDLE hEventNotify;
} DSBPOSITIONNOTIFY;

メンバ

• dwOffset
  バッファーの先頭から通知イベントがトリガーされる位置までのオフセット、または DSBPN_OFFSETSTOP です。
• hEventNotify
  オフセットに到達したときに通知されるイベントへのハンドルです。

解説　

dwOffset メンバーを DSBPN_OFFSETSTOP 値に設定すると、再生またはキャプチャーが停止したときにイベントが通知されます。これは、バッファーの最後に達して再生またはキャプチャーがループしていない場合、またはアプリケーションが IDirectSoundBuffer8::Stop メソッドまたは IDirectSoundCaptureBuffer8::Stop メソッドを呼び出した場合に起こります。

任意のボイス管理フラグと共に DSBCAPS_LOCDEFER および DSBCAPS_CTRLPOSITIONNOTIFY を指定して再生バッファーを作成すると、通知が設定されているが、まだ通知に達していないサウンドは、ボイス管理によって終了されることがあります。この場合、イベントは通知されません。

要件

ヘッダー: DSound.h 宣言

関連項目

再生バッファーの通知 | キャプチャー バッファーの通知