Microsoft DirectX 8.0 (C++)

IDirectSoundNotify8::SetNotificationPositions

通知位置を設定する。キャプチャや再生の間、呼び出し側が提供した配列内の DSBPOSITIONNOTIFY 構造体のいずれかで指定されているオフセットに読み込みまたは再生カーソルが達すると、関連するイベントがシグナル送信される。

HRESULT SetNotificationPositions(
  DWORD dwPositionNotifies, 
  LPCDSBPOSITIONNOTIFY pcPositionNotifies 
);

パラメータ

dwPositionNotifies
DSBPOSITIONNOTIFY 構造体の数。
pcPositionNotifies
DSBPOSITIONNOTIFY 構造体から成る配列へのポインタ。

戻り値

成功した場合は DS_OK を返す。

失敗した場合は、次のいずれかのエラー値を返す。

DSERR_INVALIDPARAM
DSERR_OUTOFMEMORY

注意

dwOffset メンバで値 DSBPN_OFFSETSTOP を指定すると、IDirectSoundBuffer8::StopIdirectSoundCaptureBuffer8::Stop メソッドを呼び出したとき、またはバッファの最後に達してループ再生を行わないときに、関連イベントをシグナル送信するよう DirectSound に指示できる。この値を使うときは、位置通知配列の最後の項目とすべきである。

位置通知配列が既に設定されている場合は、メソッドによって以前の配列が置き換えられる。

このメソッドを呼び出すときは、バッファを停止させなければならない。

動作環境

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