Funzione WdfFileObjectGetDevice (wdffileobject.h)

[Si applica a KMDF e UMDF]

Il metodo WdfFileObjectGetDevice restituisce l'oggetto dispositivo framework associato a un oggetto file framework specificato.

Sintassi

WDFDEVICE WdfFileObjectGetDevice(
  [in] WDFFILEOBJECT FileObject
);

Parametri

[in] FileObject

Handle per un oggetto file framework.

Valore restituito

WdfFileObjectGetDevice restituisce un handle all'oggetto dispositivo framework associato all'oggetto file framework specificato.

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

Commenti

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

Esempio

L'esempio di codice seguente illustra come una funzione di callback EvtFileClose può ottenere l'oggetto dispositivo framework associato a un oggetto file framework specificato.

VOID
MyEvtFileClose(
    IN WDFFILEOBJECT  FileObject
    )
{
    WDFDEVICE device;

    device = WdfFileObjectGetDevice(FileObject);
...
}

Requisiti

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