Função WdfUsbTargetPipeWdmGetPipeHandle (wdfusb.h)
[Aplica-se somente ao KMDF]
O método WdfUsbTargetPipeWdmGetPipeHandle retorna o identificador do tipo USBD_PIPE_HANDLE associado a um objeto de pipe de estrutura especificado.
Sintaxe
USBD_PIPE_HANDLE WdfUsbTargetPipeWdmGetPipeHandle(
[in] WDFUSBPIPE UsbPipe
);
Parâmetros
[in] UsbPipe
Um identificador para um objeto de pipe de estrutura que foi obtido chamando WdfUsbInterfaceGetConfiguredPipe.
Retornar valor
WdfUsbTargetPipeWdmGetPipeHandle retorna um identificador do tipo USBD_PIPE_HANDLE.
Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.
Comentários
Um driver baseado em estrutura precisa obter um identificador do tipo USBD_PIPE_HANDLE somente se ele criar um URB que exija um identificador de pipe.
O driver pode chamar o método WdfUsbTargetPipeWdmGetPipeHandle depois de chamar WdfUsbTargetDeviceSelectConfig. O identificador do tipo USBD_PIPE_HANDLE que WdfUsbTargetPipeWdmGetPipeHandle retorna é válido até que o driver chame WdfUsbTargetDeviceSelectConfig novamente, o driver chame WdfUsbInterfaceSelectSetting ou o objeto pipe da estrutura seja excluído. Se o driver fornecer uma função EvtCleanupCallback para o objeto de pipe da estrutura e se o objeto for excluído antes que o driver chame WdfUsbTargetDeviceSelectConfig novamente ou chame WdfUsbInterfaceSelectSetting, o identificador será válido até que a função EvtCleanupCallback do objeto retorne.
Para obter mais informações sobre o método WdfUsbTargetPipeWdmGetPipeHandle e destinos de E/S USB, consulte Destinos de E/S USB.
Exemplos
O exemplo de código a seguir obtém o identificador do tipo USBD_PIPE_HANDLE para um pipe especificado.
USBD_PIPE_HANDLE usbdPipeHandle;
usbdPipeHandle = WdfUsbTargetPipeWdmGetPipeHandle(UsbPipe);
Requisitos
| Requisito | Valor |
|---|---|
| Plataforma de Destino | Universal |
| Versão mínima do KMDF | 1.0 |
| Cabeçalho | wdfusb.h (inclua Wdfusb.h) |
| Biblioteca | Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.) |
| IRQL | <=DISPATCH_LEVEL |
| Regras de conformidade de DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf), UsbKmdfIrql(kmdf), UsbKmdfIrql2(kmdf), UsbKmdfIrqlExplicit(kmdf) |