Share via

IPortableDeviceCapabilities：：GetFunctionalObjects 方法 (portabledeviceapi.h)

  • 项目

GetFunctionalObjects 方法检索与设备上的指定类别匹配的所有功能对象。

语法

HRESULT GetFunctionalObjects(
  [in]  REFGUID                              Category,
  [out] IPortableDevicePropVariantCollection **ppObjectIDs
);

parameters

[in] Category

一个 REFGUID，指定要搜索的类别。 可以WPD_FUNCTIONAL_CATEGORY_ALL返回所有功能对象。

[out] ppObjectIDs

一个变量的地址，该变量接收指向 IPortableDevicePropVariantCollection 接口的指针，该接口包含函数对象的对象 ID 作为字符串 (类型VT_LPWSTR检索到的 PROPVARIANT 项) 。 如果未找到所请求类型的对象，则这是一个空集合， (非 NULL) 。 调用方在完成此接口时必须释放此接口。

返回值

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

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

注解

此操作通常很快，因为驱动程序不需要执行完整的内容枚举，并且检索到的功能对象数通常小于 10。 如果未找到所请求类型的对象，则此方法不会返回错误，而是返回 ppObjectID 的空集合。

示例

有关如何使用此方法的示例，请参阅 检索设备的功能对象标识符

要求

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

请参阅

IPortableDeviceCapabilities 接口

检索设备的功能对象标识符

检索设备支持的呈现功能