Share via

IWDFIoRequest::GetCreateParameters-Methode (wudfddi.h)

  • Artikel

[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 GetCreateParameters-Methode ruft die Anforderungsparameter für eine create-type-Anforderung ab.

Syntax

void GetCreateParameters(
  [out, optional] ULONG  *pOptions,
  [out, optional] USHORT *pFileAttributes,
  [out, optional] USHORT *pShareAccess
);

Parameter

[out, optional] pOptions

Ein Zeiger auf eine Variable, die eine Bitmaske von Flags empfängt, die die Optionen angibt, die beim Erstellen oder Öffnen der Datei angewendet werden, die der Anforderung zugeordnet ist, und die Aktion, die ausgeführt werden soll, wenn die Datei bereits vorhanden ist.

Die hohen 8 Bits dieses Parameters entsprechen dem CreateDisposition-Parameter der ZwCreateFile-Funktion im Kernelmodus. Diese 8 Bits geben die auszuführende Aktion an, je nachdem, ob die Datei bereits vorhanden ist. Beachten Sie, dass sich diese Dispositionswerte von den Werten unterscheiden, die im dwCreationDisposition-Parameter der Win32 CreateFile-Funktion verwendet werden.

Die niedrigen 24 Bits dieses Parameters entsprechen dem CreateOptions-Parameter von ZwCreateFile.

Dieser Parameter ist optional. Der Treiber kann NULL übergeben, wenn der Treiber die Informationen nicht benötigt.

[out, optional] pFileAttributes

Ein Zeiger auf eine Variable, die eine Bitmaske von Attributflags empfängt, die beim Erstellen oder Öffnen der Datei angewendet wird, die der Anforderung zugeordnet ist. Explizit angegebene Attribute werden nur angewendet, wenn die Datei erstellt, ersetzt oder in einigen Situationen überschrieben wird. Standardmäßig wird das Einzelne FILE_ATTRIBUTE_NORMAL-Flag angegeben. Dieses Flag kann jedoch von jedem anderen Flag oder von einer bitweisen OR-Kombination kompatibler Flags überschrieben werden. Die Bitmaske von Attributflags entspricht dem FileAttributes-Parameter von ZwCreateFile.

Dieser Parameter ist optional. Der Treiber kann NULL übergeben, wenn der Treiber die Informationen nicht benötigt.

[out, optional] pShareAccess

Ein Zeiger auf eine Variable, die eine Bitmaske von Flags empfängt, die die Freigabezugriffsrechte angeben, die für die Datei angefordert werden, die der Anforderung zugeordnet ist. Wenn die empfangene Bitmaske null ist, wird exklusiver Zugriff angefordert. Weitere Informationen zum Freigabezugriff finden Sie in der Beschreibung des ShareAccess-Parameters von ZwCreateFile.

Dieser Parameter ist optional. Der Treiber kann NULL übergeben, wenn der Treiber die Informationen nicht benötigt.

Rückgabewert

Keine

Bemerkungen

Obwohl der Treiber optional NULL für jeden der Parameter pOptions, pFileAttributes und pShareAccess angeben kann, muss der Treiber mindestens einen Parameter ohne NULL angeben, damit GetCreateParameters erfolgreich ausgeführt werden kann.

Anforderungen

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

Weitere Informationen

IWDFIoRequest

ZwCreateFile