Función WdfUsbTargetDeviceGetInterface (wdfusb.h)
[Se aplica a KMDF y UMDF]
El método WdfUsbTargetDeviceGetInterface devuelve un identificador al objeto de interfaz USB del marco asociado a un índice de interfaz especificado.
Sintaxis
WDFUSBINTERFACE WdfUsbTargetDeviceGetInterface(
[in] WDFUSBDEVICE UsbDevice,
[in] UCHAR InterfaceIndex
);
Parámetros
[in] UsbDevice
Identificador de un objeto de dispositivo USB obtenido de una llamada anterior a WdfUsbTargetDeviceCreateWithParameters.
[in] InterfaceIndex
Valor de índice de base cero que especifica un objeto de interfaz USB en la configuración actual. Este valor de índice podría no ser el mismo que el número de interfaz que define la especificación USB.
Valor devuelto
WdfUsbTargetDeviceGetInterface devuelve un identificador a un objeto de interfaz USB. Si el valor de interfaceIndex de no es válido, este método devuelve NULL.
Se produce una comprobación de errores si un identificador de objeto proporcionado por el controlador no es válido.
Observaciones
Para obtener más información sobre el método WdfUsbTargetDeviceGetInterface 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 el primer objeto de interfaz USB que el marco ha creado para un dispositivo USB. A continuación, el ejemplo obtiene el número de puntos de conexión asociados al objeto de interfaz.
WDFUSBINTERFACE UsbInterface;
BYTE numEndpoints;
UsbInterface = WdfUsbTargetDeviceGetInterface(
deviceContext->UsbTargetDevice,
0
);
numEndpoints = WdfUsbInterfaceGetNumEndpoints(
UsbInterface,
0
);
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 | <=DISPATCH_LEVEL |
| reglas de cumplimiento de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |