Freigeben über


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

WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME

WDF_IO_TARGET_OPEN_PARAMS_INIT_EXISTING_DEVICE

WdfIoTargetOpen