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

WASAPI 系列中 COM 接口的 IID，例如 IAudioClient。

[in] activationParams

特定于接口的激活参数。 有关详细信息，请参阅 IMMDevice：：Activate 中的 pActivationParams 参数。

从 Windows 10 内部版本 20438 开始，可以指定 AUDIOCLIENT_ACTIVATION_PARAMS 来激活接口，以包含或排除与指定进程 ID 关联的音频流。

[in] completionHandler

调用方实现的接口，当激活过程的结果可用时，由 Windows 调用。

activationOperation

返回一个 IActivateAudioInterfaceAsyncOperation 接口，该接口表示激活请求 的 WASAPI 接口的异步作。

返回值

该函数返回 HRESULT。 可能的值包括但不限于下表中的值。

言论

此函数使 Windows 应用商店应用能够在 Windows.Devices 和 Windows.Media.Devices 命名空间中使用 Windows 运行时 API 来选择音频设备后激活某些 WASAPI COM 接口。

对于许多实现，应用程序必须从主 UI 线程调用此函数以激活 WASAPI 系列中的 COM 接口，以便系统可以向用户显示对话框。 应用程序通过 completionHandler 传递 IActivateAudioInterfaceCompletionHandler 回调 COM 接口。 当激活结果可用时，Windows 从 COM 多线程单元（MTA）中的辅助线程调用应用程序的 IActivateAudioInterfaceCompletionHandler 接口中的方法。 然后，应用程序可以在 IActivateAudioInterfaceAsyncOperation 接口中调用方法，以检索结果代码和请求的 WASAPI 接口。 有一些激活是显式安全的，因此不需要从主 UI 线程调用此函数。 这些显式安全激活包括：

• 使用指定音频呈现设备和指定 IAudioClient 接口的 riid，使用 deviceInterfacePath 调用 ActivateAudioInterfaceAsync。
• 使用指定音频呈现 设备和指定 IAudioEndpointVolume 接口的 deviceInterfacePath 调用 ActivateAudioInterfaceAsync。
• 从会话 0 服务调用 ActivateAudioInterfaceAsync 。 有关详细信息，请参阅 服务。