IDirectSoundNotify8::SetNotificationPositions
SetNotificationPositions メソッドは、通知位置を設定します。キャプチャーまたは再生中に、読み取りカーソルまたは再生カーソルが、指定されたオフセットのいずれかに到達するたびに、関連するイベントが通知されます。
HRESULT
SetNotificationPositions(
DWORD dwPositionNotifies,
LPCDSBPOSITIONNOTIFY pcPositionNotifies
);
パラメータ
- dwPositionNotifies
DSBPOSITIONNOTIFY 構造体の数です。 - pcPositionNotifies
DSBPOSITIONNOTIFY 構造体の配列へのポインターです (配列の最大サイズは DSBNOTIFICATIONS_MAX です)。
戻り値
成功した場合は、DS_OK を返します。失敗した場合は、次のいずれかのエラー値を返します。
リターン コード |
DSERR_INVALIDPARAM |
DSERR_OUTOFMEMORY |
解説
dwOffset メンバーで値 DSBPN_OFFSETSTOP を指定すると、Stop メソッドや Stop メソッドが呼び出されたとき、またはバッファーの最後に達して再生がループされないときに、関連するイベントを通知するよう DirectSound に指示することができます。この値を使用する場合は、位置通知配列の最後の項目として指定する必要があります。
位置通知配列が既に設定されている場合は、メソッドによって以前の配列が置き換えられます。
このメソッドを呼び出すときは、バッファーを停止する必要があります。
要件
ヘッダー: DSound.h 宣言
ライブラリ: Dsound3d.dll 内容