WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME-Funktion (wdfiotarget.h)
[Gilt für KMDF und UMDF]
Die WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME-Funktion initialisiert die WDF_IO_TARGET_OPEN_PARAMS Struktur eines Treibers, sodass der Treiber ein E/A-Ziel öffnen kann, indem er den Namen des Geräts, der Datei oder der Geräteschnittstelle angibt. Wenn der angegebene Name nicht vorhanden ist, versucht das System nicht, ihn zu erstellen.
Syntax
void WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME(
[out] PWDF_IO_TARGET_OPEN_PARAMS Params,
[in] PCUNICODE_STRING TargetDeviceName,
[in] ACCESS_MASK DesiredAccess
);
Parameter
[out] Params
Ein Zeiger auf eine vom Treiber zugewiesene WDF_IO_TARGET_OPEN_PARAMS-Struktur , die von der Funktion initialisiert wird.
[in] TargetDeviceName
Ein Wert für das TargetDeviceName-Element der WDF_IO_TARGET_OPEN_PARAMS-Struktur .
[in] DesiredAccess
Ein Wert für den DesiredAccess-Member der WDF_IO_TARGET_OPEN_PARAMS-Struktur .
Rückgabewert
Keine
Bemerkungen
Wenn TargetDeviceName den Namen einer bereits vorhandenen Datei angibt, öffnet das System die vorhandene Datei. Wenn die Datei nicht vorhanden ist, tritt beim Öffnen ein Fehler auf.
Die WDF_IO_TARGET_OPEN_PARAMS-Struktur wird als Eingabe für die WdfIoTargetOpen-Methode verwendet.
Die WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME-Funktion initialisiert die Elemente Size, Type, TargetDeviceName, DesiredAccess, CreateOptions und CreateDisposition der angegebenen WDF_IO_TARGET_OPEN_PARAMS-Struktur .
KMDF Die funktion WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME initialisiert den CreateDisposition-Member , um FILE_OPEN.
UMDF Die WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME-Funktion initialisiert den CreateDisposition-Member , um OPEN_EXISTING.
Weitere Informationen zu E/A-Zielen finden Sie unter Verwenden von E/A-Zielen.
Beispiele
Ein Codebeispiel, das WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME verwendet, finden Sie unter WdfIoTargetOpen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfiotarget.h (include Wdf.h) |
| IRQL | Beliebige Ebene |
Weitere Informationen
WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME