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)

Consulte también

USB_DEVICE_DESCRIPTOR

WdfUsbTargetDeviceCreateWithParameters