Compartilhar via


Método GetDescriptor da classe CIM_USBDevice (gerenciamento do Hyper-V)

Retorna o descritor USBDevice conforme especificado pelos parâmetros de entrada.

Sintaxe

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

Parâmetros

RequestType [in]

Mapa de bits que identifica o tipo de solicitação de descritor e o destinatário. O tipo de solicitação pode ser 'standard', 'class' ou 'vendor-specific'. O destinatário pode ser 'device', 'interface', 'endpoint' ou 'other'. Consulte a Especificação USB para obter os valores apropriados para cada bit.

RequestValue [in]

Contém o Tipo de Descritor no byte alto e o Índice do Descritor (por exemplo, índice ou deslocamento para a matriz descritor) no byte baixo. Consulte a Especificação USB para obter mais informações.

RequestIndex [in]

Define o código de ID de linguagem de 2 bytes usado pelo USBDevice ao retornar dados do Descritor de cadeia de caracteres. O parâmetro normalmente é 0 para descritores que não são de cadeia de caracteres. Consulte a Especificação USB para obter mais informações.

RequestLength [in, out]

Na entrada, contém o comprimento (em octetos) do Descritor que deve ser retornado. Se esse valor for menor que o comprimento real do Descritor, somente o comprimento solicitado será retornado. Se for maior que o comprimento real, o comprimento real será retornado. Na saída, esse parâmetro é o comprimento, em octetos, do Buffer que está sendo retornado. Se o Descritor solicitado não existir, o conteúdo desse parâmetro será indefinido.

Buffer [out]

Retorna as informações solicitadas do Descritor. Se o Descritor não existir, o conteúdo do parâmetro será indefinido.

Valor retornado

Retorna um 0 com êxito; caso contrário, retornará um erro.

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 8.1
Servidor mínimo com suporte
Windows Server 2012 R2
Namespace
Root\virtualization\v2
MOF
WindowsVirtualization.V2.mof
DLL
Vmms.exe

Confira também

CIM_USBDevice