Funzione WdfFileObjectWdmGetFileObject (wdffileobject.h)

  • Articolo

[Si applica solo a KMDF]

Il metodo WdfFileObjectWdmGetFileObject restituisce l'oggetto file WDM (Windows Driver Model) associato a un oggetto file framework specificato.

Sintassi

PFILE_OBJECT WdfFileObjectWdmGetFileObject(
  [in] WDFFILEOBJECT FileObject
);

Parametri

[in] FileObject

Handle per un oggetto file framework.

Valore restituito

WdfFileObjectWdmGetFileObject restituisce un puntatore alla struttura FILE_OBJECT associata all'oggetto file framework specificato oppure NULL se non è presente alcun oggetto file WDM per l'oggetto file framework specificato.

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

Commenti

Il puntatore restituito dal metodo WdfFileObjectWdmGetFileObject è valido fino a quando non viene eliminato l'oggetto file framework. Se il driver fornisce una funzione EvtCleanupCallback per l'oggetto file framework, il puntatore è valido fino a quando non viene restituita la funzione di callback.

Per altre informazioni sugli oggetti file framework, vedere Framework File Objects.

Esempio

Nell'esempio di codice seguente viene ottenuto un handle per l'oggetto file WDM associato a un oggetto file framework specificato.

PFILE_OBJECT  pReturnedFileObject;

pReturnedFileObject = WdfFileObjectWdmGetFileObject(fileObject);

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Intestazione wdffileobject.h (include Wdf.h)
Libreria Wdf01000.sys (vedere Controllo delle versioni della libreria framework).
IRQL <=DISPATCH_LEVEL
Regole di conformità DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

FILE_OBJECT