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. Es werden keine neuen Features zu UMDF 1 hinzugefügt, und es gibt eingeschränkte Unterstützung für UMDF 1 für neuere Versionen von Windows 10. 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 Bitkennzeichnungen empfängt, die Dateierstellungsoptionen angeben. Diese FILE_XXXX benannten Bitkennzeichnungen werden in Wdm.h definiert.

Die niedrigen 24 Bit der Variablen geben Optionen an, die beim Erstellen oder Öffnen der Datei angewendet werden sollen. Weitere Informationen zu diesen Bits finden Sie in der Beschreibung des CreateOptions Parameter des Kernelmodus ZwCreateFile--Funktion.

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

Dieser Parameter ist optional und kann NULL-werden.

[out, optional] pFileAttributes

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

Dieser Parameter ist optional und kann NULL-werden.

[out, optional] pShareAccess

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

Dieser Parameter ist optional und kann NULL-werden.

[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 parameter DesiredAccess parameter of ZwCreateFile.

Dieser Parameter ist optional und kann NULL-werden.

Rückgabewert

Nichts

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 GetCreateParametersExaufrufen 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

Anforderung Wert
Ende des Supports In UMDF 2.0 und höher nicht verfügbar.
Zielplattform- Desktop
Mindest-UMDF-Version 1.9
Header- wudfddi.h (include Wudfddi.h)
DLL- WUDFx.dll

Siehe auch

IQueueCallbackCreate::OnCreateFile

IWDFIoRequest2-

IWDFIoRequest::GetCreateParameters