EVT_WDF_DEVICE_FILE_CREATE Rückruffunktion (wdfdevice.h)

[Gilt für KMDF und UMDF]

Die EvtDeviceFileCreate Rückruffunktion eines Treibers verarbeitet Vorgänge, die ausgeführt werden müssen, wenn eine Anwendung den 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 zu einem Framework-Geräteobjekt.

[in] Request

Ein Handle zu einem Framework-Anforderungsobjekt, das eine Dateierstellungsanforderung darstellt.

[in] FileObject

Ein Handle zu einem 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

Nichts

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. Lesen oder Schreiben einer Datei.

Der Treiber kann das Request Handle an WdfRequestGetParameters übergeben, um Parameter abzurufen, die der Dateierstellungsanforderung zugeordnet sind. Die Parameter werden im Parameters.Create Member 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 abschließen oder mit WDF_REQUEST_SEND_OPTION_SEND_AND_FORGETsenden.

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

Weitere Informationen zu Framework-Dateiobjekten und der EvtDeviceFileCreate Rückruffunktion finden Sie unter Framework File Objects.

Anforderungen

Siehe auch

WDF_FILEOBJECT_CONFIG