Función WdfUsbInterfaceGetEndpointInformation (wdfusb.h)
[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) |