Función WdfUsbTargetDeviceGetInterface (wdfusb.h)

  • Artículo

[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 interfaceIndex 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.

Comentarios

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, en el ejemplo se 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 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 <=DISPATCH_LEVEL
Reglas de cumplimiento de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf)

Consulte también

WdfUsbTargetDeviceCreateWithParameters