Función WdfUsbTargetDeviceWdmGetConfigurationHandle (wdfusb.h)
[Solo se aplica a KMDF]
El método WdfUsbTargetDeviceWdmGetConfigurationHandle devuelve el identificador con tipo USBD_CONFIGURATION_HANDLE asociado a la configuración actual de un dispositivo USB especificado.
Sintaxis
USBD_CONFIGURATION_HANDLE WdfUsbTargetDeviceWdmGetConfigurationHandle(
[in] WDFUSBDEVICE UsbDevice
);
Parámetros
[in] UsbDevice
Identificador de un objeto de dispositivo USB obtenido de una llamada anterior a WdfUsbTargetDeviceCreateWithParameters.
Valor devuelto
Si el controlador ha seleccionado una configuración para el dispositivo, WdfUsbTargetDeviceWdmGetConfigurationHandle devuelve el identificador de tipo USBD_CONFIGURATION_HANDLE del dispositivo. De lo contrario, el método devuelve NULL.
Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.
Observaciones
Un controlador basado en marcos debe obtener un identificador con tipo USBD_CONFIGURATION_HANDLE solo si crea un URB de que contiene una estructura de _URB_SELECT_INTERFACE.
El controlador puede llamar a WdfUsbTargetDeviceWdmGetConfigurationHandle después de llamar a WdfUsbTargetDeviceSelectConfig. El identificador con tipo USBD_CONFIGURATION_HANDLE que WdfUsbTargetDeviceWdmGetConfigurationHandle devuelve es válido hasta que el controlador llama a WdfUsbTargetDeviceSelectConfig o se elimina el objeto de dispositivo USB. Si el controlador proporciona una función EvtCleanupCall back para el objeto de dispositivo USB y, si el objeto se elimina antes de que el controlador llame a WdfUsbTargetDeviceSelectConfig, el identificador es válido hasta que la función EvtCleanupCallback del objeto devuelve.
Para obtener más información sobre el método de WdfUsbTargetDeviceWdmGetConfigurationHandle y los destinos de E/S USB, consulte destinos de E/S USB.
Ejemplos
En el ejemplo de código siguiente se obtiene un identificador para la configuración actual de un dispositivo USB especificado.
USBD_CONFIGURATION_HANDLE deviceConfigHdl;
deviceConfigHdl = WdfUsbTargetDeviceWdmGetConfigurationHandle(UsbDevice);
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Universal |
| versión mínima de KMDF | 1.0 |
| encabezado de | wdfusb.h (incluya Wdfusb.h) |
| biblioteca de | Wdf01000.sys (consulte Control de versiones de la biblioteca de marcos). |
| irQL | <=DISPATCH_LEVEL |
| reglas de cumplimiento de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |