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