Método GetDescriptor da classe CIM_USBHub

O método GetDescriptor retorna o descritor do hub USB conforme especificado pelos parâmetros de entrada.

Importante

As classes CIM do DMTF (Distributed Management Task Force) (Common Information Model) são as classes pai nas quais as classes WMI são criadas. Atualmente, o WMI dá suporte apenas aos esquemas de versão cim 2.x.

Este tópico usa a sintaxe MOF (Managed Object Format). Para obter mais informações sobre como usar esse método, consulte Chamando um método.

Sintaxe

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

Parâmetros

RequestType [in]

Identificador mapeado por bit para o tipo de solicitação de descritor e o destinatário. Para obter os valores apropriados para cada bit, consulte a especificação USB.

RequestValue [in]

Contém o tipo de descritor no byte alto e no índice do descritor (por exemplo, índice ou deslocamento para a matriz do descritor) no byte baixo. Para obter mais informações, consulte a especificação USB.

RequestIndex [in]

Especifica o código do identificador de linguagem de 2 bytes usado pelo dispositivo USB ao retornar dados do descritor de cadeia de caracteres. O parâmetro normalmente é 0 (zero) para descritores nãostring. Para obter mais informações, consulte a especificação USB.

RequestLength [in, out]

Na entrada, 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, 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]

O buffer retorna as informações do descritor solicitado. Se o descritor não existir, o conteúdo do buffer será indefinido.

Valor retornado

Retornará um valor de 0 (zero) se o descritor USB for retornado com êxito, 1 (um) se a solicitação não tiver suporte e qualquer outro número para indicar um erro. Em uma subclasse, o conjunto de possíveis códigos de retorno pode ser especificado usando um qualificador ValueMap no método . As cadeias de caracteres para as quais o conteúdo do mofqualifier é traduzido também podem ser especificadas na subclasse como um qualificador de matriz De valores .

Comentários

Atualmente, esse método não é implementado pelo WMI. Para usar esse método, você deve implementá-lo em seu próprio provedor.

Esta documentação é derivada das descrições da classe CIM publicadas pelo DMTF. A Microsoft pode ter feito alterações para corrigir erros secundários, estar em conformidade com os padrões de documentação do SDK da Microsoft ou fornecer mais informações.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows Vista
Servidor mínimo com suporte	Windows Server 2008
Namespace	Root\CIMV2
Cabeçalho	Wmcodecdsp.h
MOF	CIMWin32.mof
DLL	CIMWin32.dll

Confira também

CIM_USBHub

CIM_USBHub