Método GetDescriptor de la clase CIM_USBHub
El método GetDescriptor devuelve el descriptor del concentrador 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. Para conocer los valores adecuados para cada bit, consulte la especificación USB.
-
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, la 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]
-
El búfer devuelve la información de descriptor solicitada. Si el descriptor no existe, el contenido del búfer 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 |
|
| MOF |
|
| Archivo DLL |
|