Función WdfUsbInterfaceGetEndpointInformation (wdfusb.h)

  • Artículo

[Se aplica a KMDF y UMDF]

El método WdfUsbInterfaceGetEndpointInformation recupera información sobre un punto de conexión de dispositivo USB especificado y su canalización asociada.

Sintaxis

void WdfUsbInterfaceGetEndpointInformation(
  [in]      WDFUSBINTERFACE           UsbInterface,
  [in]      UCHAR                     SettingIndex,
  [in]      UCHAR                     EndpointIndex,
  [in, out] PWDF_USB_PIPE_INFORMATION EndpointInfo
);

Parámetros

[in] UsbInterface

Identificador de un objeto de interfaz USB obtenido mediante una llamada a WdfUsbTargetDeviceGetInterface.

[in] SettingIndex

Valor de índice que identifica una configuración alternativa para la interfaz. Para obtener más información sobre la configuración alternativa, consulte la especificación USB.

[in] EndpointIndex

Valor de índice que identifica un punto de conexión asociado a la configuración alternativa especificada de la interfaz especificada. (Este valor de índice no es la dirección del punto de conexión).

[in, out] EndpointInfo

Puntero a una estructura de WDF_USB_PIPE_INFORMATION asignada por el autor de la llamada que el marco rellena.

Valor devuelto

None

Observaciones

Se produce una comprobación de errores si el controlador proporciona un identificador de objeto no válido.

Para obtener más información sobre el método WdfUsbInterfaceGetEndpointInformation y los destinos de E/S USB, consulte Destinos de E/S USB.

Ejemplos

En el ejemplo de código siguiente se obtiene el número de puntos de conexión que admite una interfaz USB y, a continuación, se llama a WdfUsbInterfaceGetEndpointInformation para cada punto de conexión.

WDF_USB_PIPE_INFORMATION endPointInfo;
BYTE settingIndex, i;

settingIndex = 0;
numEndpoints = WdfUsbInterfaceGetNumEndpoints(
                                          UsbInterface,
                                          settingIndex
                                          );

for (i = 0; i < numEndpoints; i++){
    WDF_USB_PIPE_INFORMATION_INIT(&endPointInfo);
    WdfUsbInterfaceGetEndpointInformation(
                                          UsbInterface,
                                          settingIndex,
                                          i,
                                          &endPointInfo
                                          );

    //
    // Examine endpoint information here.
    //
...
}

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

WDF_USB_PIPE_INFORMATION

WdfUsbInterfaceGetNumEndpoints

WdfUsbTargetDeviceGetInterface