Funzione WdfIoTargetWdmGetTargetFileObject (wdfiotarget.h)

  • Articolo

[Si applica solo a KMDF]

Il metodo WdfIoTargetWdmGetTargetFileObject restituisce un puntatore all'oggetto file WDM (Windows Driver Model) associato a una destinazione di I/O remota specificata.

Sintassi

PFILE_OBJECT WdfIoTargetWdmGetTargetFileObject(
  [in] WDFIOTARGET IoTarget
);

Parametri

[in] IoTarget

Handle a un oggetto di destinazione di I/O remoto. Questo handle è stato ottenuto da una chiamata precedente a WdfIoTargetCreate.

Valore restituito

WdfIoTargetWdmGetTargetFileObject restituisce un puntatore a una struttura di FILE_OBJECT WDM.

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

Commenti

Il puntatore restituito dal metodo WdfIoTargetWdmGetTargetFileObject è valido fino a quando il driver chiama WdfIoTargetClose o WdfIoTargetCloseForQueryRemove o fino all'eliminazione dell'oggetto di destinazione I/O remoto. Se il driver fornisce una funzione EvtCleanupCallback per l'oggetto di destinazione di I/O remoto e se l'oggetto viene eliminato prima della chiusura della destinazione di I/O remota, il puntatore è valido fino a quando non viene restituita la funzione EvtCleanupCallback .

Se il driver tenta di accedere all'oggetto dispositivo WDM dopo che è stato rimosso, il driver può causare l'arresto anomalo del sistema. L'esempio di avviso popup illustra come il driver può fornire una funzione di callback EvtIoTargetQueryRemove in modo che venga notificata se la destinazione di I/O viene rimossa.

Per altre informazioni su WdfIoTargetWdmGetTargetFileObject, 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.

Esempio

Nell'esempio di codice seguente viene ottenuto un puntatore all'oggetto file WDM associato a una destinazione di I/O remota.

PFILE_OBJECT pfileObject;

pfileObject = WdfIoTargetWdmGetTargetFileObject(IoTarget);

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Intestazione wdfiotarget.h (include Wdf.h)
Libreria Wdf01000.sys (vedere Framework Library Versioning).
IRQL <=DISPATCH_LEVEL
Regole di conformità DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

FILE_OBJECT

WdfIoTargetCreate

WdfIoTargetWdmGetTargetDeviceObject

WdfIoTargetWdmGetTargetFileHandle