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 规范,请参阅 USB 规范。

RequestValue [in]

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

RequestIndex [in]

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

RequestLength [in, out]

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

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

缓冲区 [out]

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

返回值

如果成功返回 USB 描述符,则返回值 0 (零) ,如果请求不受支持,则返回 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