Funzione WdfUsbTargetPipeGetIoTarget (wdfusb.h)

  • Articolo

[Si applica a KMDF e UMDF]

Il metodo WdfUsbTargetPipeGetIoTarget restituisce un handle all'oggetto di destinazione I/O associato a una pipe USB specificata.

Sintassi

WDFIOTARGET WdfUsbTargetPipeGetIoTarget(
  [in] WDFUSBPIPE Pipe
);

Parametri

[in] Pipe

Handle a un oggetto pipe del framework ottenuto chiamando WdfUsbInterfaceGetConfiguredPipe.

Valore restituito

WdfUsbTargetPipeGetIoTarget restituisce un handle all'oggetto di destinazione I/O associato all'oggetto pipe specificato.

Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.

Commenti

Per altre informazioni sul metodo WdfUsbTargetPipeGetIoTarget e sulle destinazioni di I/O USB, vedere Destinazioni di I/O USB.

Esempio

Nell'esempio di codice seguente viene illustrato come una funzione di callback EvtDeviceD0Entry può avviare un lettore continuo per una 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;
}

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Versione UMDF minima 2,0
Intestazione wdfusb.h (include Wdfusb.h)
Libreria Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL Qualsiasi livello
Regole di conformità DDI DriverCreate(kmdf), FailD0EntryIoTargetState(kmdf)

Vedi anche

WdfUsbInterfaceGetConfiguredPipe

WdfUsbTargetDeviceGetIoTarget