Funzione WdfFileObjectWdmGetFileObject (wdffileobject.h)
[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) |