Método GetDescriptor da classe CIM_USBDevice (Wmcodecdsp.h)
O método GetDescriptor retorna o descritor de dispositivo 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. 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 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, 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]
-
Retorna as informações do descritor solicitado. Se o descritor não existir, o conteúdo desse parâmetro 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 |
|
| MOF |
|
| DLL |
|