DirectSoundFullDuplexCreate8
DirectSound オブジェクトおよび DirectSoundCapture オブジェクトを作成し、IDirectSoundFullDuplex8 インターフェイスを返す。この関数を使うには、Microsoft Windows XP が必要である。全二重は他のオペレーティング システムに実装できるが、キャプチャ デバイスとレンダリング デバイスは個別に作成されなければならない。
構文
HRESULT WINAPI DirectSoundFullDuplexCreate8(
LPCGUID
pcGuidCaptureDevice
,
LPCGUID
pcGuidRenderDevice
,
LPCDSCBUFFERDESC
pcDSCBufferDesc
,
LPCDSBUFFERDESC
pcDSBufferDesc
,
HWND
hWnd
,
DWORD
dwLevel
,
LPDIRECTSOUNDFULLDUPLEX*
ppDSFD
,
LPDIRECTSOUNDCAPTUREBUFFER8 *
ppDSCBuffer8
,
LPDIRECTSOUNDBUFFER8 *
ppDSBuffer8
,
LPUNKNOWN
pUnkOuter
);
パラメータ
pcGuidCaptureDevice
全二重入力用のサウンド キャプチャ デバイスを示す GUID のアドレス。DirectSoundCaptureEnumerate が返す GUID のいずれか、デフォルトのキャプチャ デバイスを指定する NULL、または次の値のいずれかでなければならない。
値 | 説明 |
DSDEVID_DefaultCapture | システムワイドなデフォルトのオーディオ キャプチャ デバイス。 |
DSDEVID_DefaultVoiceCapture | デフォルトの音声キャプチャ デバイス。 |
pcGuidRenderDevice
全二重出力用のサウンド レンダリング デバイスを示す GUID のアドレス。DirectSoundEnumerate が返す GUID のいずれか、デフォルトのレンダリング デバイスを指定する NULL、または次の値のいずれかでなければならない。
値 | 説明 |
DSDEVID_DefaultPlayback | システムワイドなデフォルトのオーディオ再生デバイス。 |
DSDEVID_DefaultVoicePlayback | デフォルトの音声再生デバイス。 |
pcDSCBufferDesc
キャプチャ バッファの特性を指定する DSCBUFFERDESC 構造体のアドレス。
pcDSBufferDesc
レンダリング バッファの特性を指定する DSBUFFERDESC 構造体のアドレス。
hWnd
アプリケーション ウインドウへのハンドル。
dwLevel
デバイスの協調レベル。詳細については、「IDirectSound8::SetCooperativeLevel」を参照すること。
ppDSFD
IDirectSoundFullDuplex8 インターフェイス ポインタを受け取る変数のアドレス。
ppDSCBuffer8
キャプチャ バッファの IDirectSoundCaptureBuffer8 インターフェイスを受け取る変数のアドレス。
ppDSBuffer8
レンダリング バッファの IDirectSoundBuffer8 インターフェイスを受け取る変数のアドレス。
pUnkOuter
COM 集成体に対する制御オブジェクトの IUnknown インターフェイスのアドレス。集成体はサポートされていないので、NULL に設定しなければならない。
戻り値
成功した場合は S_OK を返す。失敗した場合は、次のいずれかの値を返す。
リターン コード |
DSERR_ALLOCATED |
DSERR_INVALIDCALL |
DSERR_INVALIDPARAM |
DSERR_NOAGGREGATION |
DSERR_NODRIVER |
DSERR_OUTOFMEMORY |
要件
** ヘッダー:**Dsound.h で宣言。
** インポート ライブラリ:**Dsound.lib を使用。
参照