EVT_WDF_DEVICE_FILE_CREATE Rückruffunktion (wdfdevice.h)

[Gilt für KMDF und UMDF]

Die Rückruffunktion EvtDeviceFileCreate eines Treibers verarbeitet Vorgänge, die ausgeführt werden müssen, wenn eine Anwendung Zugriff auf ein Gerät anfordert.

Syntax

EVT_WDF_DEVICE_FILE_CREATE EvtWdfDeviceFileCreate;

void EvtWdfDeviceFileCreate(
  [in] WDFDEVICE Device,
  [in] WDFREQUEST Request,
  [in] WDFFILEOBJECT FileObject
)
{...}

Parameter

[in] Device

Ein Handle für ein Framework-Geräteobjekt.

[in] Request

Ein Handle für ein Frameworkanforderungsobjekt, das eine Dateierstellungsanforderung darstellt.

[in] FileObject

Ein Handle für ein Frameworkdateiobjekt, das eine Datei beschreibt, die für die angegebene Anforderung geöffnet wird. Dieser Parameter ist NULL , wenn der Treiber WdfFileObjectNotRequired für das FileObjectClass-Element der WDF_FILEOBJECT_CONFIG-Struktur angegeben hat.

Rückgabewert

Keine

Bemerkungen

Das Framework ruft die EvtDeviceFileCreate-Rückruffunktion eines Treibers auf, wenn eine Benutzeranwendung oder ein anderer Treiber das Gerät öffnet, um einen E/A-Vorgang auszuführen, z. B. das Lesen oder Schreiben einer Datei.

Der Treiber kann das Anforderungshandle an WdfRequestGetParameters übergeben, um Parameter abzurufen, die der Dateierstellungsanforderung zugeordnet sind. Die Parameter werden im Parameter.Create-Element der WDF_REQUEST_PARAMETERS-Struktur gespeichert.

Diese Rückruffunktion wird synchron im Kontext des Threads aufgerufen, der das Gerät öffnet.

Um eine EvtDeviceFileCreate-Rückruffunktion zu registrieren, muss der Treiber die WdfDeviceInitSetFileObjectConfig-Methode aufrufen.

Der Treiber muss die Anforderung entweder ausfüllen oder mit WDF_REQUEST_SEND_OPTION_SEND_AND_FORGET senden.

Alternativ kann der Treiber Erstellungsanforderungen in einer Warteschlange empfangen. Weitere Informationen finden Sie unter WdfDeviceConfigureRequestDispatching.

Weitere Informationen zu Frameworkdateiobjekten und der Rückruffunktion EvtDeviceFileCreate finden Sie unter Frameworkdateiobjekte.

Anforderungen

Anforderung	Wert
Zielplattform	Universell
KMDF-Mindestversion	1.0
UMDF-Mindestversion	2.0
Kopfzeile	wdfdevice.h (einschließen von Wdf.h)
IRQL	PASSIVE_LEVEL

Weitere Informationen

WDF_FILEOBJECT_CONFIG