Funzione WdfDeviceGetIoTarget (wdfdevice.h)

Articolo
03/05/2024

[Si applica a KMDF e UMDF]

Il metodo WdfDeviceGetIoTarget restituisce un handle alla destinazione di I/O locale di una funzione o di un driver di filtro per 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 del 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.

Commenti

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, hanno esito negativo 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.

Esempio

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

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Versione UMDF minima	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