Поделиться через


Метод GetDescriptor класса CIM_USBDevice (управление Hyper-V)

Возвращает дескриптор USBDevice в соответствии с входными параметрами.

Синтаксис

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]

Определяет 2-байтовый код идентификатора языка, используемый USBDevice при возврате данных дескриптора строки. Для дескрипторов, не являющихся строковыми, обычно используется значение 0. Дополнительные сведения см. в разделе Спецификация USB.

RequestLength [вход, выход]

Во входных данных содержит длину (в октетах) дескриптора, который должен быть возвращен. Если это значение меньше фактической длины дескриптора, возвращается только запрошенная длина. Если она превышает фактическую длину, возвращается фактическая длина. В выходных данных этот параметр представляет длину возвращаемого буфера в октетах. Если запрошенный дескриптор не существует, содержимое этого параметра не определено.

Буфер [out]

Возвращает запрошенные сведения дескриптора. Если дескриптор не существует, содержимое параметра не определено.

Возвращаемое значение

Возвращает значение 0 при успешном выполнении; в противном случае возвращает ошибку.

Требования

Требование Значение
Минимальная версия клиента
Windows 8.1
Минимальная версия сервера
Windows Server 2012 R2
Пространство имен
Root\virtualization\v2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

См. также раздел

CIM_USBDevice