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
);
Die Parameter
[out] Params
Ein Zeiger auf eine vom Treiber zugewiesene WDF_IO_TARGET_OPEN_PARAMS Struktur, die die Funktion initialisiert.
[in] TargetDeviceName
Ein Wert für das TargetDeviceName Member der WDF_IO_TARGET_OPEN_PARAMS-Struktur.
[in] DesiredAccess
Ein Wert für das DesiredAccess Member der WDF_IO_TARGET_OPEN_PARAMS-Struktur.
Rückgabewert
Nichts
Bemerkungen
Wenn TargetDeviceName den Namen einer datei angibt, die bereits vorhanden ist, öffnet das System die vorhandene Datei. Wenn die Datei nicht vorhanden ist, schlägt der Öffnenvorgang fehl.
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 Size, Type, TargetDeviceName, DesiredAccess, CreateOptionsund CreateDisposition Member der angegebenen WDF_IO_TARGET_OPEN_PARAMS Struktur.
KMDF-Die WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME-Funktion initialisiert das CreateDisposition-elementFILE_OPEN.
UMDF-Die WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME-Funktion initialisiert das CreateDisposition-elementOPEN_EXISTING.
Weitere Informationen zu E/A-Zielen finden Sie unter Using I/O Targets.
Beispiele
Ein Codebeispiel, das WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAMEverwendet, finden Sie unter WdfIoTargetOpen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | universell |
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Kopfzeile | wdfiotarget.h (include Wdf.h) |
| IRQL | Beliebige Ebene |
Siehe auch
WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME