Función WdfUsbTargetDeviceGetDeviceDescriptor (wdfusb.h)
[Se aplica a KMDF y UMDF]
El método WdfUsbTargetDeviceGetDeviceDescriptor recupera el descriptor del dispositivo USB para el dispositivo USB asociado a un objeto de dispositivo USB especificado.
Sintaxis
void WdfUsbTargetDeviceGetDeviceDescriptor(
[in] WDFUSBDEVICE UsbDevice,
[out] PUSB_DEVICE_DESCRIPTOR UsbDeviceDescriptor
);
Parámetros
[in] UsbDevice
Identificador de un objeto de dispositivo USB obtenido de una llamada anterior a WdfUsbTargetDeviceCreateWithParameters.
[out] UsbDeviceDescriptor
Puntero a una estructura de USB_DEVICE_DESCRIPTOR asignada por el autor de la llamada que recibe el descriptor del dispositivo USB.
Valor devuelto
Ninguno
Observaciones
Se produce una comprobación de errores si un identificador de objeto proporcionado por el controlador no es válido.
Para obtener más información sobre el método de WdfUsbTargetDeviceGetDeviceDescriptor y los destinos de E/S USB, consulte destinos de E/S USB.
Ejemplos
En el ejemplo de código siguiente se obtiene el descriptor de dispositivo USB para un dispositivo. En el ejemplo se almacena el descriptor en el espacio de contexto definido por el controlador.
PMY_DEVICE_CONTEXT myDeviceContext;
myDeviceContext = GetDeviceContext(device);
WdfUsbTargetDeviceGetDeviceDescriptor(
myDeviceContext->UsbTargetDevice,
&myDeviceContext->UsbDeviceDescr
);
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| versión mínima de UMDF | 2.0 |
| encabezado de | wdfusb.h (incluya Wdfusb.h) |
| biblioteca de | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| irQL | PASSIVE_LEVEL |
| reglas de cumplimiento de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |