DirectPlayVoiceTest8.CheckAudioSetup
指定されたデバイスに対してオーディオ セットアップ ウィザードを実行する。この関数は、デバイスにいくつかのテストを行い、全二重オーディオを利用できるかどうかを確認する。また、マイクが接続されており、キャプチャ デバイスで正しく動作するかどうかを確認する。
CheckAudioSetup( _
guidPlaybackDevice As String, _
guidCaptureDevice As String, _
hwndOwner As Long, _
lFlags As Long) As Long
指定項目
- guidPlaybackDevice
- テストする再生デバイスを識別する GUID。このパラメータに空文字列を渡した場合、Microsoft® DirectPlay® Voice は Microsoft® DirectSound® に定義されているデフォルトの音声再生デバイスをテストする。
- guidCaptureDevice
- テストするキャプチャ デバイスを識別する GUID。このパラメータに空文字列を渡した場合、DirectPlay® Voice は DirectSound に定義されているデフォルトの音声キャプチャ デバイスをテストする。
- hwndOwner
- このメソッドにより呼び出されるテスト ウィザードはモーダルである。ウィザードの親ウィンドウになるウィンドウが呼び出し元のアプリケーションにある場合、そのウィンドウへのハンドルをこのパラメータで渡す必要がある。呼び出し元アプリケーションにウィンドウがない場合、0 を渡すことができる。DVFLAGS_QUERYONLY フラグを指定した場合、このパラメータは使用されず、アプリケーションは 0 を渡すことができる。
- lFlags
- フラグ。次のフラグを設定できる。
- DVFLAGS_QUERYONLY
- オーディオ セットアップは実行されない。その代わり、メソッドはレジストリを調べ、デバイスがテストされているかどうかを確認する。デバイスがテストされていない場合、メソッドは DVERR_RUNSETUP を返す。デバイスがテストされている場合、デバイスが全二重オーディオをサポートしていれば、メソッドは DV_FULLDUPLEX を返し、デバイスが全二重オーディオをサポートしていなければ、メソッドは DV_HALFDUPLEX を返す。
- DVFLAGS_ALLOWBACK
- ウィザードのウェルカム ページで [戻る] ボタンが有効になる。ユーザーがウェルカム ページの [戻る] ボタンをクリックすると、ウィザードは終了し、CheckAudioSetup は DVERR_USERBACK を返す。
エラー コード
失敗した場合は、Err.Number に次のいずれかの値が設定される。
注意
このメソッドはユーザー インターフェイス (UI) の要素を含み、ダイアログ ボックスを表示する。DVFLAGS_QUERYONLY フラグを指定すると、テストは実際には実行されず、UI は起動しない。その代わり、レジストリを調べ、デバイスの以前のテスト結果を確認する。