Funzione WdfUsbTargetPipeGetIoTarget (wdfusb.h)
[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 per 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.
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
Osservazioni
Per altre informazioni sul metodo WdfUsbTargetPipeGetIoTarget e sulle destinazioni I/O USB, vedere Destinazioni I/O USB.
Esempi
L'esempio di codice seguente mostra come un EvtDeviceD0Entry funzione di callback possa 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;
}
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Universale |
| versione minima di KMDF | 1.0 |
| versione minima di UMDF | 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) |