Platform SDK: DirectX

DSBPOSITIONNOTIFY

DSBPOSITIONNOTIFY 型は、DirectSoundBuffer.SetNotificationPositionsDirectSoundCaptureBuffer.SetNotificationPositions の各メソッドによって使われる。

Type DSBPOSITIONNOTIFY
    hEventNotify As Long
    lOffset As Long
End Type

メンバ

hEventNotify
指定のオフセットに達したときにシグナル送信するイベントへのハンドル。DirectX7.CreateEvent メソッドを使ってこのハンドルを取得する。
lOffset
バッファの先頭から、通知イベントがトリガされる場所までのオフセット、または DSBPN_OFFSETSTOP。「注意」を参照すること。

注意

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

ボイス管理フラグと共に DSBCAPS_LOCDEFER と DSBCAPS_NOTIFY を使用している場合は、通知を保持するサウンドは設定できるが、到達することなくボイス管理によって終了されることもある。この場合、通知イベントは発生しない。