CIM_USBDevice 类的 GetDescriptor 方法 (Hyper-V 管理)

返回输入参数指定的 USBDevice 描述符。

语法

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

参数

RequestType [in]

标识描述符请求和收件人类型的位映射。 请求类型可以是“标准”、“类”或“特定于供应商”。 接收方可以是“device”、“interface”、“endpoint”或“other”。 有关每个位的相应值,请参阅 USB 规范。

RequestValue [in]

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

RequestIndex [in]

定义 USBDevice 在返回字符串描述符数据时使用的 2 字节语言 ID 代码。 对于非字符串描述符, 参数通常为 0。 有关详细信息,请参阅 USB 规范。

RequestLength [in, out]

输入时,包含应返回的描述符) 八进制数 (长度。 如果此值小于描述符的实际长度,则仅返回请求的长度。 如果大于实际长度,则返回实际长度。 输出时,此参数是返回的 Buffer 的长度(以八位字节为单位)。 如果请求的描述符不存在,则此参数的内容未定义。

Buffer [out]

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

返回值

成功时返回 0;否则,将返回错误。

要求

要求
最低受支持的客户端
Windows 8.1
最低受支持的服务器
Windows Server 2012 R2
命名空间
Root\virtualization\v2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

另请参阅

CIM_USBDevice