Compartilhar via

Função WdfUsbTargetPipeWdmGetPipeHandle (wdfusb.h)

  • Artigo

[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)

Confira também

URB

WdfUsbInterfaceGetConfiguredPipe

WdfUsbTargetDeviceSelectConfig