Método GetDescriptor de la clase CIM_USBDevice (Wmcodecdsp.h)

El método GetDescriptor devuelve el descriptor de dispositivo USB especificado por los parámetros de entrada.

Importante

Las clases CIM (Grupo de tareas de administración distribuida) DMTF (Common Information Model) son las clases primarias en las que se compilan las clases WMI. WMI actualmente solo admite los esquemas de versión cim 2.x.

En este tema se usa la sintaxis de Managed Object Format (MOF). Para obtener más información sobre el uso de este método, vea Llamar a un método.

Sintaxis

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

Parámetros

RequestType [in]

Identificador asignado a bits para el tipo de solicitud de descriptor y el destinatario. Consulte la especificación USB para conocer los valores adecuados para cada bit.

RequestValue [in]

Contiene el tipo de descriptor en el byte alto y el índice del descriptor (por ejemplo, índice o desplazamiento en la matriz descriptor) en el byte bajo. Para obtener más información, consulte la especificación USB.

RequestIndex [in]

Especifica el código de identificador de idioma de 2 bytes utilizado por el dispositivo USB al devolver datos del descriptor de cadena. El parámetro suele ser 0 (cero) para descriptores que no son de cadena. Para obtener más información, consulte la especificación USB.

RequestLength [entrada, salida]

En la entrada, longitud (en octetos) del descriptor que se debe devolver. Si este valor es menor que la longitud real del descriptor, solo se devuelve la longitud solicitada. Si es mayor que la longitud real, se devuelve la longitud real.

En la salida, se devuelve la longitud (en octetos) del búfer. Si el descriptor solicitado no existe, el contenido de este parámetro no está definido.

Búfer [out]

Devuelve la información de descriptor solicitada. Si el descriptor no existe, el contenido de este parámetro no está definido.

Valor devuelto

Devuelve un valor de 0 (cero) si el descriptor USB se devuelve correctamente, 1 (uno) si no se admite la solicitud y cualquier otro número para indicar un error. En una subclase, se podría especificar el conjunto de posibles códigos de retorno mediante un calificador ValueMap en el método . Las cadenas a las que se traduce el contenido de mofqualifier también se pueden especificar en la subclase como calificador de matriz Values .

Comentarios

Actualmente, WMI no implementa este método. Para usar este método, debe implementarlo en su propio proveedor.

Esta documentación se deriva de las descripciones de clase CIM publicadas por DMTF. Microsoft puede haber realizado cambios para corregir errores menores, cumplir los estándares de documentación de Microsoft SDK o proporcionar más información.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista
Servidor mínimo compatible	Windows Server 2008
Espacio de nombres	Root\CIMV2
Encabezado	Wmcodecdsp.h
MOF	CIMWin32.mof
Archivo DLL	CIMWin32.dll

Consulte también

CIM_USBDevice

CIM_USBDevice