ActivateAudioInterfaceAsync 関数 (mmdeviceapi.h)

Windows ストア アプリが WASAPI ファミリ内の既存のコンポーネント オブジェクト モデル (COM) インターフェイスにアクセスできるようにします。

構文

HRESULT ActivateAudioInterfaceAsync(
  [in] LPCWSTR                                  deviceInterfacePath,
  [in] REFIID                                   riid,
  [in] PROPVARIANT                              *activationParams,
  [in] IActivateAudioInterfaceCompletionHandler *completionHandler,
       IActivateAudioInterfaceAsyncOperation    **activationOperation
);

パラメーター

[in] deviceInterfacePath

オーディオ デバイスのデバイス インターフェイス ID。 これは通常、 DeviceInformation オブジェクトまたは MediaDevice クラスのいずれかのメソッドから取得されます。

GUID DEVINTERFACE_AUDIO_CAPTURE と DEVINTERFACE_AUDIO_RENDER は、それぞれ既定のオーディオ キャプチャとレンダー デバイスを表します。 StringFromIID 呼び出して、これらの GUID のいずれかを、この引数に使用する LPCWSTR に変換します。

プロセス ループバック キャプチャのオーディオ インターフェイスをアクティブ化する VIRTUAL_AUDIO_DEVICE_PROCESS_LOOPBACK を指定します。 プロセス ループバック キャプチャ シナリオを示すサンプル コードについては、 アプリケーション ループバック API キャプチャのサンプルを参照してください。

[in] riid

IAudioClient など、 WASAPI ファミリ内の COM インターフェイスの IID。

[in] activationParams

インターフェイス固有のアクティブ化パラメーター。 詳細については、IMMDevice::Activateの pActivationParams パラメーター を参照してください。

Windows 10 ビルド 20438 以降では、インターフェイスをアクティブ化する AUDIOCLIENT_ACTIVATION_PARAMS を指定して、指定したプロセス ID に関連付けられているオーディオ ストリームを含めたり除外したりできます。

[in] completionHandler

アクティブ化プロシージャの結果が使用可能な場合に Windows によって呼び出される呼び出し元によって実装されるインターフェイス。

activationOperation

要求された WASAPI インターフェイスをアクティブ化する非同期操作を表す IActivateAudioInterfaceAsyncOperation インターフェイス を返します。

戻り値

この関数は HRESULT を返します。 使用できる値には、次の表に示す値が含まれますが、これらに限定されません。

備考

この関数を使用すると、Windows ストア アプリは、Windows.Devices で Windows ランタイム API を使用した後、特定の WASAPI COM インターフェイスをアクティブ化し、Windows.Media.Devices 名前空間を してオーディオ デバイスを選択できます。

多くの実装では、システムがダイアログをユーザーに表示できるように、アプリケーションでメイン UI スレッドからこの関数を呼び出して WASAPI ファミリの COM インターフェイスをアクティブ化する必要があります。 アプリケーションは、completionHandler を介して IActivateAudioInterfaceCompletionHandler コールバック COM インターフェイスを渡します。 Windows は、アクティブ化の結果が使用可能な場合、COM マルチスレッド アパートメント (MTA) のワーカー スレッドからアプリケーションの IActivateAudioInterfaceCompletionHandler インターフェイスのメソッドを呼び出します。 その後、アプリケーションは IActivateAudioInterfaceAsyncOperation インターフェイスでメソッドを呼び出して、結果コードと WASAPI インターフェイス 要求されたメソッドを取得できます。 明示的に安全であり、メイン UI スレッドからこの関数を呼び出す必要がないアクティブ化がいくつかあります。 これらの明示的に安全なアクティブ化には、次のようなものがあります。

• オーディオ レンダー デバイスを指定する deviceInterfacePath と IAudioClient インターフェイスを指定する riid を使用して ActivateAudioInterfaceAsync を呼び出します。
• オーディオ レンダー デバイスを指定する deviceInterfacePath と IAudioEndpointVolume インターフェイスを指定する riid を使用して ActivateAudioInterfaceAsync を呼び出します。
• セッション 0 サービスから ActivateAudioInterfaceAsync 呼び出します。 詳細については、「 サービス」を参照してください。