Funzione WdfDeviceGetIoTarget (wdfdevice.h)

Articolo
02/07/2025

[Si applica a KMDF e UMDF]

Il metodo WdfDeviceGetIoTarget restituisce un handle a una funzione o a un driver di filtro destinazione I/O localeper un dispositivo specificato.

Sintassi

WDFIOTARGET WdfDeviceGetIoTarget(
  [in] WDFDEVICE Device
);

Parametri

[in] Device

Handle per un oggetto dispositivo framework.

Valore restituito

Se l'operazione ha esito positivo, WdfDeviceGetIoTarget restituisce un handle a un oggetto di destinazione di I/O framework. Se l'oggetto dispositivo framework specificato rappresenta un PDO, il metodo restituisce NULL.

Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.

Osservazioni

Quando un driver UMDF invia una richiesta creata dal driver a una destinazione di I/O locale, la richiesta non ha alcun oggetto file associato. Alcune destinazioni inferiori, ad esempio un PDO non elaborato con enumerazione HIDClass, non riescono le richieste che non hanno alcun oggetto file associato. In questo caso, un driver UMDF può specificare WdfIoTargetOpenLocalTargetByFile per creare una destinazione di I/O che rappresenta lo stack inferiore (proprio come una destinazione locale) usando un handle di file. Di conseguenza, tutte le richieste create dal driver inviate a questa destinazione di I/O sono associate all'oggetto file corrispondente all'handle aperto.

A tale scopo, chiamare la funzione WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE prima di chiamare WdfIoTargetOpen.

Per altre informazioni sulle destinazioni di I/O, vedere Uso delle destinazioni di I/O.

Esempi

Nell'esempio di codice seguente viene ottenuto un handle per la destinazione di I/O locale di un dispositivo specificato.

WDFIOTARGET  ioTargetHandle;

ioTargetHandle = WdfDeviceGetIoTarget(device);

Fabbisogno

Requisito	Valore
piattaforma di destinazione	Universale
versione minima di KMDF	1.0
versione minima di UMDF	2.0
intestazione	wdfdevice.h (include Wdf.h)
libreria	Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL	<= DISPATCH_LEVEL
regole di conformità DDI	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Condividi tramite