Microsoft DirectX 8.0 |
このインターフェイスは、DSound オーディオ レンダラ フィルタで実装される。アプリケーションでは、IAMDirectSound インターフェイスを使用して、ほかのサウンド アプリケーションにフォーカスが設定されている場合に、アプリケーションのサウンドが依然として聞こえるかどうかを制御し、サウンドに関連付けられるアプリケーションのウィンドウを制御する。
注 : このインターフェイスに現在実装されているのは、GetWindowFocus メソッドと SetWindowFocus メソッドだけである。
vtable 順のメソッド
IUnknown メソッド 説明 QueryInterface サポートされているインターフェイスへのポインタを返す。 AddRef 参照カウントをインクリメントする。 Release 参照カウントをデクリメントする。 IAMDirectSound メソッド 説明 GetDirectSoundInterface 現在は実装されていない。 GetPrimaryBufferInterface 現在は実装されていない。 GetSecondaryBufferInterface 現在は実装されていない。 ReleaseDirectSoundInterface 現在は実装されていない。 ReleasePrimaryBufferInterface 現在は実装されていない。 ReleaseSecondaryBufferInterface 現在は実装されていない。 SetWindowFocus 現在のメディア ファイルのサウンド再生を処理するウィンドウを設定する。 GetWindowFocus 現在のメディア ファイルのサウンド再生を処理しているウィンドウを取得する。
このメソッドは現在実装されていない。E_NOTIMPL を返す。
構文
HRESULT GetDirectSoundInterface( LPDIRECTSOUND *lplpds );
パラメータ
- lplpds
- 現在のサウンド デバイスのインターフェイスを指す、IDirectSound インターフェイスへのポインタのアドレス。
戻り値
E_NOTIMPL を返す。
実装されると、このメソッドは次のいずれかの値を返す。
E_FAIL 利用できるサウンド デバイスはない。 E_INVALIDARG lplpds パラメータが NULL である。 E_NOTIMPL DirectSound がインストールされていない。 NOERROR メソッドが成功した。
このメソッドは現在実装されていない。E_NOTIMPL を返す。
構文
HRESULT GetDirectSoundInterface( LPDIRECTSOUNDBUFFER *lplpdsb );
パラメータ
- lplpdsb
- 現在のサウンド デバイスのプライマリ サウンド バッファを指す、IDirectSoundBuffer インターフェイスへのポインタのアドレス。
戻り値
E_NOTIMPL を返す。
実装されると、このメソッドは次のいずれかの値を返す。
E_FAIL 利用できるサウンド デバイスはない。 E_INVALIDARG lplpdsb パラメータが NULL である。 E_NOTIMPL DirectSound がインストールされていない。 NOERROR メソッドが成功した。
このメソッドは現在実装されていない。E_NOTIMPL を返す。
構文
HRESULT GetSecondaryBufferInterface( LPDIRECTSOUNDBUFFER *lplpdsb );
パラメータ
- lplpdsb
- IDirectSoundBuffer インターフェイスへのポインタのアドレス。終了時には、現在のサウンド デバイスのセカンダリ サウンド バッファを指す。
戻り値
E_NOTIMPL を返す。
実装されると、このメソッドは次のいずれかの値を返す。
E_FAIL 利用できるサウンド デバイスはない。 E_INVALIDARG lplpdsb パラメータが NULL である。 E_NOTIMPL DirectSound がインストールされていない。 NOERROR メソッドが成功した。
現在のメディア ファイルのサウンド再生を処理しているウィンドウを取得する。
構文
HRESULT GetWindowFocus( HWND hWnd, BOOL bMixingOnOrOff );
パラメータ
- hWnd
- サウンド再生ウィンドウへのハンドル。この値が NULL の場合、サウンドはウィンドウに関連付けられていない。Windows NT® 4.0 では、現在、ウィンドウなしでのサウンド再生はサポートされていないので注意すること。
- bMixingOnOrOff
- サウンドをミキシングするか (TRUE)、ミキシングしないか (FALSE) を示す値。
戻り値
次のいずれかの値を返す。
E_FAIL 利用できるサウンド デバイスはない。 E_INVALIDARG 引数 hWnd が無効である。 E_NOTIMPL DirectSound がインストールされていない。 NOERROR メソッドが成功した。
このメソッドは現在実装されていない。E_NOTIMPL を返す。
構文
HRESULT ReleaseDirectSoundInterface( LPDIRECTSOUND lpds );
パラメータ
- lpds
- 解放する IDirectSound インターフェイスへのポインタ。
戻り値
E_NOTIMPL を返す。
実装されると、このメソッドは次のいずれかの値を返す。
E_FAIL 指定の IDirectSound インターフェイスへの参照がなく、これを解放できない。 E_INVALIDARG lpds パラメータが NULL である。 NOERROR メソッドが成功した。
このメソッドは現在実装されていない。E_NOTIMPL を返す。
構文
HRESULT ReleasePrimaryBufferInterface( LPDIRECTSOUNDBUFFER lpdsb
);
パラメータ
- lpdsb
- 解放する IDirectSoundBuffer インターフェイスへのポインタ。
戻り値
E_NOTIMPL を返す。
実装されると、このメソッドは次のいずれかの値を返す。
E_FAIL 指定の IDirectSoundBuffer インターフェイスへの参照がなく、これを解放できない。 E_INVALIDARG lpdsb パラメータが NULL である。 NOERROR メソッドが成功した。
このメソッドは現在実装されていない。E_NOTIMPL を返す。
構文
HRESULT ReleaseSecondaryBufferInterface( LPDIRECTSOUNDBUFFER lpdsb );
パラメータ
- lpdsb
- 解放する IDirectSoundBuffer インターフェイスへのポインタ。
戻り値
E_NOTIMPL を返す。
実装されると、このメソッドは次のいずれかの値を返す。
E_FAIL 指定の IDirectSoundBuffer インターフェイスへの参照がなく、これを解放できない。 E_INVALIDARG lpdsb パラメータが NULL である。 NOERROR メソッドが成功した。
現在のメディア ファイルのサウンド再生を処理するウィンドウを設定する。
構文
HRESULT SetWindowFocus( HWND hWnd, BOOL bMixingOnOrOff );
パラメータ
- hWnd
- サウンド再生ウィンドウへのハンドル。この値が NULL の場合、サウンドはウィンドウに関連付けられない。Windows NT 4.0 では、現在、ウィンドウなしでのサウンド再生はサポートされていないので注意すること。
- bMixingOnOrOff
- サウンドをミキシングするか (TRUE)、ミキシングしないか (FALSE) を示す値。
戻り値
次のいずれかの値を返す。
E_FAIL 利用できるサウンド デバイスはない。 E_INVALIDARG 引数 hWnd が無効である。 E_NOTIMPL DirectSound がインストールされていない。 NOERROR メソッドが成功した。