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 |
|