IPortableDeviceCapabilities::GetFunctionalCategories 方法 (portabledeviceapi.h)

GetFunctionalCategories 方法检索设备支持的所有功能类别。

语法

HRESULT GetFunctionalCategories(
  [out] IPortableDevicePropVariantCollection **ppCategories
);

参数

[out] ppCategories

接收指向 IPortableDevicePropVariantCollection 接口的指针的变量的地址,该接口包含此设备的所有功能类别。 在检索到的 PROPVARIANT 值中,这些值将是类型为 VT_CLSID 的 GUID。 调用方在使用完此接口后必须释放此接口。

返回值

该方法返回 HRESULT。 可能的值包括(但并不限于)下表中的项。

返回代码 说明
S_OK
方法成功。

注解

功能类别描述设备可以执行的功能类型,例如图像捕获、音频捕获和存储。 此方法通常非常快,因为驱动程序通常仅在启动时查询设备并缓存结果。

示例

有关如何使用此方法的示例,请参阅 检索设备支持的功能类别

要求

要求
目标平台 Windows
标头 portabledeviceapi.h
Library PortableDeviceGUIDs.lib

另请参阅

IPortableDeviceCapabilities 接口

检索设备支持的功能类别