Microsoft DirectX 8.0 (C++) |
通知位置を設定する。キャプチャや再生の間、呼び出し側が提供した配列内の DSBPOSITIONNOTIFY 構造体のいずれかで指定されているオフセットに読み込みまたは再生カーソルが達すると、関連するイベントがシグナル送信される。
HRESULT SetNotificationPositions( DWORD dwPositionNotifies, LPCDSBPOSITIONNOTIFY pcPositionNotifies );
成功した場合は DS_OK を返す。
失敗した場合は、次のいずれかのエラー値を返す。
DSERR_INVALIDPARAM |
DSERR_OUTOFMEMORY |
dwOffset メンバで値 DSBPN_OFFSETSTOP を指定すると、IDirectSoundBuffer8::Stop や IdirectSoundCaptureBuffer8::Stop メソッドを呼び出したとき、またはバッファの最後に達してループ再生を行わないときに、関連イベントをシグナル送信するよう DirectSound に指示できる。この値を使うときは、位置通知配列の最後の項目とすべきである。
位置通知配列が既に設定されている場合は、メソッドによって以前の配列が置き換えられる。
このメソッドを呼び出すときは、バッファを停止させなければならない。
ヘッダー : dsound.h で宣言。