IWDFIoRequest::GetCreateParameters-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 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 angeben, die beim Erstellen oder Öffnen der Datei angewendet werden, die der Anforderung zugeordnet ist, und die Auszuführende Aktion, wenn die Datei bereits vorhanden ist.
Die hohen 8 Bit dieses Parameters entsprechen dem CreateDisposition Parameter des Kernelmodus ZwCreateFile Funktion. 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 in der dwCreationDisposition Parameter der Win32-CreateFile--Funktion verwendet werden.
Die niedrigen 24 Bit 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 Attributkennzeichnungen 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, abgelöst oder in einigen Situationen überschrieben wird. Standardmäßig wird das einzelne FILE_ATTRIBUTE_NORMAL Flag angegeben. Diese Kennzeichnung kann jedoch von jeder anderen Kennzeichnung oder durch eine bitweise ODER Kombination kompatibler Flags überschrieben werden. Die Bitmaske der Attributkennzeichnungen 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 Freigeben des Zugriffs 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
Nichts
Bemerkungen
Obwohl der Treiber optional NULL- für jeden der pOptions-, pFileAttributesund pShareAccess--Parameter angeben kann, muss der Treiber mindestens einen Nicht-NULL--Parameter angeben, damit GetCreateParameter s erfolgreich ausgeführt werden kann.
Anforderungen
| Anforderung | Wert |
|---|---|
| Ende des Supports | In UMDF 2.0 und höher nicht verfügbar. |
| Zielplattform- | Desktop |
| Mindest-UMDF-Version | 1.5 |
| Header- | wudfddi.h (include Wudfddi.h) |
| DLL- | WUDFx.dll |