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 |
| 标头 |
|
| MOF |
|
| DLL |
|