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 de marco 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
None
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 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 del 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 | Value |
|---|---|
| Plataforma de destino | Universal |
| Versión mínima de KMDF | 1.0 |
| Versión mínima de UMDF | 2.0 |
| Encabezado | wdfusb.h (incluya Wdfusb.h) |
| Library | 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) |