IWDFIoRequest2::GetCreateParametersEx-Methode (wudfddi.h)

[Warnung: UMDF 2 ist die neueste Version von UMDF und ersetzt UMDF 1. Alle neuen UMDF-Treiber sollten mit UMDF 2 geschrieben werden. UMDF 1 werden keine neuen Features hinzugefügt, und die Unterstützung für UMDF 1 für neuere Versionen von Windows 10 ist eingeschränkt. Universelle Windows-Treiber müssen UMDF 2 verwenden. Weitere Informationen finden Sie unter Erste Schritte mit UMDF.]

Die GetCreateParametersEx-Methode ruft Dateierstellungsparameter ab, die einer Datei zugeordnet sind, die erstellt oder geöffnet wird.

Syntax

void GetCreateParametersEx(
  [out, optional] ULONG       *pOptions,
  [out, optional] USHORT      *pFileAttributes,
  [out, optional] USHORT      *pShareAccess,
  [out, optional] ACCESS_MASK *pDesiredAccess
);

Parameter

[out, optional] pOptions

Ein Zeiger auf eine vom Aufrufer zugewiesene Variable, die Bitflags empfängt, die Dateierstellungsoptionen angeben. Diese FILE_XXXX benannten Bitflags sind in Wdm.h definiert.

Die niedrigen 24 Bits der Variablen weisen auf Optionen hin, die beim Erstellen oder Öffnen der Datei angewendet werden sollen. Weitere Informationen zu diesen Bits finden Sie in der Beschreibung des CreateOptions-Parameters der ZwCreateFile-Funktion im Kernelmodus.

Die hohen acht Bits der Variablen zeigen Aktionen an, die ausgeführt werden sollen, wenn die Datei bereits vorhanden ist oder nicht. Weitere Informationen zu diesen Bits finden Sie in der Beschreibung des CreateDisposition-Parameters von ZwCreateFile.

Dieser Parameter ist optional und kann NULL sein.

[out, optional] pFileAttributes

Ein Zeiger auf eine vom Aufrufer zugewiesene Variable, die Bitflags empfängt, die Dateiattribute angeben. Diese FILE_ATTRIBUTE_XXXX benannten Bitflags sind in Wdm.h definiert. Weitere Informationen zu diesen Bitflags finden Sie in der Beschreibung des FileAttributes-Parameters von ZwCreateFile.

Dieser Parameter ist optional und kann NULL sein.

[out, optional] pShareAccess

Ein Zeiger auf eine vom Aufrufer zugewiesene Variable, die Bitflags empfängt, die Dateifreigabeoptionen angeben. Diese FILE_SHARE_XXXX benannten Bitflags werden in Wdm.h definiert. Weitere Informationen zu diesen Bitflags finden Sie in der Beschreibung des ShareAccess-Parameters von ZwCreateFile.

Dieser Parameter ist optional und kann NULL sein.

[out, optional] pDesiredAccess

Ein Zeiger auf eine vom Aufrufer zugewiesene ACCESS_MASK Struktur, die den angeforderten Zugriff auf die Datei angibt. Weitere Informationen zu diesem Parameter finden Sie im DesiredAccess-Parameter von ZwCreateFile.

Dieser Parameter ist optional und kann NULL sein.

Rückgabewert

Keine

Bemerkungen

Nachdem das Framework die IQueueCallbackCreate::OnCreateFile-Rückruffunktion eines Treibers aufgerufen hat, kann der Treiber die IWDFIoRequest::GetCreateParameters-Methode oder die IWDFIoRequest2::GetCreateParametersEx-Methode aufrufen, um die Erstellungsparameter der Datei abzurufen.

Weitere Informationen finden Sie unter Abrufen von Parametern für E/A-Anforderungen.

Beispiele

Das folgende Codebeispiel zeigt, wie eine IQueueCallbackCreate::OnCreateFile-Rückruffunktion die IWDFIoRequest2-Schnittstelle abrufen und dann GetCreateParametersEx aufrufen kann.

VOID
OnCreateFile(
    __in IWDFIoQueue* FxQueue,
    __in IWDFIoRequest* FxRequest,
    __in IWDFFile* FxFile
    )
{
    ULONG fileOptions;
    USHORT fileAttributes,
    USHORT shareAccess,
    ACCESS_MASK desiredAccess;
    ...
    CComQIPtr<IWDFIoRequest2> fxRequest2(FxRequest);
    fxRequest2->GetCreateParametersEx(&fileOptions
                                      &fileAttributes,
                                      &shareAccess,
                                      &desiredAccess);
    ...
}

Anforderungen

Weitere Informationen

IQueueCallbackCreate::OnCreateFile

IWDFIoRequest2

IWDFIoRequest::GetCreateParameters