CIM_USBDevice 类的 GetDescriptor 方法 (Wmcodecdsp.h)

  • 项目

GetDescriptor 方法返回输入参数指定的 USB 设备描述符。

重要

DMTF (分布式管理任务组) CIM (Common Information Model) 类是生成 WMI 类的父类。 WMI 目前仅支持 CIM 2.x 版本架构。

本主题使用托管对象格式 (MOF) 语法。 有关使用此方法的详细信息，请参阅 调用方法。

语法

uint32 GetDescriptor(
  [in]      uint8  RequestType,
  [in]      uint16 RequestValue,
  [in]      uint16 RequestIndex,
  [in, out] uint16 RequestLength,
  [out]     uint8  Buffer[]
);

参数

RequestType [in]

描述符请求和收件人类型的位映射标识符。 有关每个位的适当值，请参阅 USB 规范。

RequestValue [in]

包含高字节中的描述符类型和描述符索引 (例如，索引或偏移量到描述符数组) 低字节。 有关详细信息，请参阅 USB 规范。

RequestIndex [in]

指定返回字符串描述符数据时 USB 设备使用的 2 字节语言标识符代码。 对于非字符串描述符，参数通常为 0 (零) 。 有关详细信息，请参阅 USB 规范。

RequestLength [in， out]

输入时，长度 (应返回的描述符) 八进制数。 如果此值小于描述符的实际长度，则仅返回请求的长度。 如果大于实际长度，则返回实际长度。

输出时，返回的缓冲区) 长度 (八进制数。 如果请求的描述符不存在，则此参数的内容未定义。

Buffer [out]

返回请求的描述符信息。 如果描述符不存在，则此参数的内容未定义。

返回值

如果成功返回 USB 描述符，则返回 0 (零) 值;如果请求不受支持，则返回 1 (1) 值，以及指示错误的任何其他数字。 在子类中，可以使用 方法上的 ValueMap 限定符指定可能的返回代码集。 还可以在子类中将 mofqualifier 内容转换为的字符串指定为 Values 数组限定符。

备注

WMI 当前未实现此方法。 若要使用此方法，必须在自己的提供程序中实现它。

本文档派生自 DMTF 发布的 CIM 类说明。 Microsoft 可能已对更正小错误、符合 Microsoft SDK 文档标准或提供详细信息进行了更改。

要求

要求 值
最低受支持的客户端
 Windows Vista
最低受支持的服务器
 Windows Server 2008
命名空间
 Root\CIMV2
标头
Wmcodecdsp.h
MOF
CIMWin32.mof
DLL
CIMWin32.dll

另请参阅

CIM_USBDevice

CIM_USBDevice