fungsi WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME (wdfiotarget.h)

Artikel
02/29/2024

[Berlaku untuk KMDF dan UMDF]

Fungsi WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME menginisialisasi struktur WDF_IO_TARGET_OPEN_PARAMS driver sehingga driver dapat membuka target I/O dengan menentukan nama perangkat, file, atau antarmuka perangkat. Jika nama yang diberikan tidak ada, sistem tidak akan mencoba membuatnya.

Sintaks

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

Penunjuk ke struktur WDF_IO_TARGET_OPEN_PARAMS yang dialokasikan driver, yang diinisialisasi fungsi.

[in] TargetDeviceName

Nilai untuk anggota TargetDeviceName dari struktur WDF_IO_TARGET_OPEN_PARAMS .

[in] DesiredAccess

Nilai untuk anggota DesiredAccess dari struktur WDF_IO_TARGET_OPEN_PARAMS .

Nilai kembali

Tidak ada

Keterangan

Jika TargetDeviceName menentukan nama file yang sudah ada, sistem akan membuka file yang ada. Jika file tidak ada, operasi buka gagal.

Struktur WDF_IO_TARGET_OPEN_PARAMS digunakan sebagai input ke metode WdfIoTargetOpen .

Fungsi WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME menginisialisasi anggota Ukuran, Jenis, TargetDeviceName, DesiredAccess, CreateOptions, dan CreateDisposition dari struktur WDF_IO_TARGET_OPEN_PARAMS yang ditentukan.

KMDF Fungsi WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME menginisialisasi anggota CreateDisposition untuk FILE_OPEN.

UMDF Fungsi WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME menginisialisasi anggota CreateDisposition untuk OPEN_EXISTING.

Untuk informasi selengkapnya tentang target I/O, lihat Menggunakan Target I/O.

Contoh

Untuk contoh kode yang menggunakan WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME, lihat WdfIoTargetOpen.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Versi KMDF minimum	1,0
Versi UMDF minimum	2.0
Header	wdfiotarget.h (termasuk Wdf.h)
IRQL	Tingkat apa pun

Lihat juga

WDF_IO_TARGET_OPEN_PARAMS

WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME

WDF_IO_TARGET_OPEN_PARAMS_INIT_EXISTING_DEVICE

WdfIoTargetBuka

Bagikan melalui