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

Метод GetDescriptor класса CIM_USBHub

  • Статья

Метод GetDescriptor возвращает дескриптор концентратора USB в соответствии с входными параметрами.

Важно!

Классы CIM (Common Information Model) DMTF (Distributed Management Task Force) являются родительскими классами, на основе которых строятся классы 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]

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

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

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

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

Буфер [out]

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

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

Возвращает значение 0 (ноль), если дескриптор USB успешно возвращен, 1 (один), если запрос не поддерживается, и любое другое число, указывающее на ошибку. В подклассе набор возможных кодов возврата можно указать с помощью квалификатора ValueMap в методе . Строки, в которые преобразуется содержимое mofqualifier , также можно указать в подклассе как квалификатор массива Values .

Комментарии

В настоящее время этот метод не реализуется WMI. Чтобы использовать этот метод, необходимо реализовать его в собственном поставщике.

Эта документация является производным от описаний классов CIM, опубликованных DMTF. Возможно, корпорация Майкрософт внесла изменения для исправления незначительных ошибок, соответствия стандартам документации по Microsoft SDK или предоставления дополнительных сведений.

Требования

Требование Значение
Минимальная версия клиента
 Windows Vista
Минимальная версия сервера
 Windows Server 2008
Пространство имен
 Root\CIMV2
Заголовок
Wmcodecdsp.h
MOF
CIMWin32.mof
DLL
CIMWin32.dll

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

CIM_USBHub

CIM_USBHub