Microsoft DirectX 8.0 (Visual Basic)

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 に次のいずれかの値が設定される。

DVERR_INVALIDPARAM
DVERR_RUNSETUP

注意

このメソッドはユーザー インターフェイス (UI) の要素を含み、ダイアログ ボックスを表示する。DVFLAGS_QUERYONLY フラグを指定すると、テストは実際には実行されず、UI は起動しない。その代わり、レジストリを調べ、デバイスの以前のテスト結果を確認する。