Funzione WdfIoTargetGetDevice (wdfiotarget.h)

[Si applica a KMDF e UMDF]

Il metodo WdfIoTargetGetDevice restituisce un handle all'oggetto dispositivo framework padre della destinazione I/O locale o remota specificata.

Sintassi

WDFDEVICE WdfIoTargetGetDevice(
  [in] WDFIOTARGET IoTarget
);

[in] IoTarget

Handle per un oggetto di destinazione di I/O. Questo handle viene ottenuto da WdfDeviceGetIoTarget, WdfIoTargetCreate o da un metodo fornito da una destinazione I/O specializzata (ad esempio WdfUsbTargetDeviceGetGetIoTarget).

WdfIoTargetGetDevice restituisce un handle a un oggetto dispositivo framework.

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

Per altre informazioni su WdfIoTargetGetDevice, vedere Ottenere informazioni su una destinazione di I/O generale.

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

Nell'esempio di codice seguente viene illustrato come una funzione di callback EvtIoTargetQueryRemove può chiamare WdfIoTargetGetDevice.

NTSTATUS
MyEvtIoTargetQueryRemove(
    WDFIOTARGET IoTarget
)
{
WDFDEVICE device;
...
device = WdfIoTargetGetDevice(IoTarget);
...
}

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Versione UMDF minima	2,0
Intestazione	wdfiotarget.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)