Compartilhar via


Função WdfUsbTargetPipeGetIoTarget (wdfusb.h)

[Aplica-se a KMDF e UMDF]

O método WdfUsbTargetPipeGetIoTarget retorna um identificador para o objeto de destino de E/S associado a um pipe USB especificado.

Sintaxe

WDFIOTARGET WdfUsbTargetPipeGetIoTarget(
  [in] WDFUSBPIPE Pipe
);

Parâmetros

[in] Pipe

Um identificador para um objeto de pipe de estrutura que foi obtido chamando WdfUsbInterfaceGetConfiguredPipe.

Retornar valor

WdfUsbTargetPipeGetIoTarget retorna um identificador para o objeto de destino de E/S associado ao objeto pipe especificado.

Um bug marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

Para obter mais informações sobre o método WdfUsbTargetPipeGetIoTarget e destinos de E/S USB, consulte Destinos de E/S USB.

Exemplos

O exemplo de código a seguir mostra como uma função de retorno de chamada EvtDeviceD0Entry pode iniciar um leitor contínuo para um pipe USB.

NTSTATUS
MyEvtDeviceD0Entry(
    IN  WDFDEVICE Device,
    IN  WDF_POWER_DEVICE_STATE PreviousState
)
{
    PDEVICE_CONTEXT  pDeviceContext;
    NTSTATUS  status;

    pDeviceContext = GetMyDeviceContext(Device);

    status = WdfIoTargetStart(WdfUsbTargetPipeGetIoTarget(pDeviceContext->InterruptPipe));

    return status;
}

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Versão mínima do UMDF 2,0
Cabeçalho wdfusb.h (inclua Wdfusb.h)
Biblioteca Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL Qualquer nível
Regras de conformidade de DDI DriverCreate(kmdf), FailD0EntryIoTargetState(kmdf)

Confira também

WdfUsbInterfaceGetConfiguredPipe

WdfUsbTargetDeviceGetIoTarget