Función WdfUsbTargetPipeWdmGetPipeHandle (wdfusb.h)

[Solo se aplica a KMDF]

El método WdfUsbTargetPipeWdmGetPipeHandle devuelve el identificador con tipo USBD_PIPE_HANDLE asociado a un objeto de canalización de marco especificado.

Sintaxis

USBD_PIPE_HANDLE WdfUsbTargetPipeWdmGetPipeHandle(
  [in] WDFUSBPIPE UsbPipe
);

Parámetros

[in] UsbPipe

Identificador de un objeto de canalización de marco que se obtuvo llamando a WdfUsbInterfaceGetConfiguredPipe.

Valor devuelto

WdfUsbTargetPipeWdmGetPipeHandle devuelve un identificador con tipo USBD_PIPE_HANDLE.

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

Observaciones

Un controlador basado en marco debe obtener un identificador con tipo USBD_PIPE_HANDLE solo si crea un URB que requiere un identificador de canalización.

El controlador puede llamar al método WdfUsbTargetPipeWdmGetPipeHandle después de llamar a WdfUsbTargetDeviceSelectConfig. El identificador con tipo USBD_PIPE_HANDLE que WdfUsbTargetPipeWdmGetPipeHandle devuelve es válido hasta que el controlador llama WdfUsbTargetDeviceSelectConfig de nuevo, el controlador llama a WdfUsbInterfaceSelectSettingo se elimina el objeto de canalización de marco. Si el controlador proporciona una función evtCleanupCallback para el objeto de canalización de marco y, si el objeto se elimina antes de que el controlador llame a WdfUsbTargetDeviceSelectConfig o llame a WdfUsbInterfaceSelectSetting, el identificador es válido hasta que la función EvtCleanupCall back del objeto devuelve.

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

Ejemplos

En el ejemplo de código siguiente se obtiene el identificador con tipo USBD_PIPE_HANDLE para una canalización especificada.

USBD_PIPE_HANDLE  usbdPipeHandle;

usbdPipeHandle = WdfUsbTargetPipeWdmGetPipeHandle(UsbPipe);

Requisitos

Consulte también

urb de

WdfUsbInterfaceGetConfiguredPipe

WdfUsbTargetDeviceSelectConfig