fungsi WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME (wdfiotarget.h)
[Berlaku untuk KMDF dan UMDF]
Fungsi WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_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 operasi akan mencoba membuatnya.
Sintaks
void WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_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 menggantikan file yang ada. Jika file tidak ada, sistem akan membuatnya.
Struktur WDF_IO_TARGET_OPEN_PARAMS digunakan sebagai input ke metode WdfIoTargetOpen .
KMDF Fungsi WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME menginisialisasi anggota Ukuran, Jenis, TargetDeviceName, DesiredAccess, dan CreateOptions dari struktur WDF_IO_TARGET_OPEN_PARAMS yang ditentukan.
UMDF Fungsi WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME menginisialisasi anggota Ukuran, Jenis, DesiredAccess, dan TargetDeviceName dari struktur WDF_IO_TARGET_OPEN_PARAMS yang ditentukan. Ini menetapkan anggota ShareAccess ke nol. Ini juga mengatur anggota FileAttributes ke FILE_ATTRIBUTE_NORMAL.
Untuk informasi selengkapnya tentang target I/O, lihat Menggunakan Target I/O.
Contoh
Contoh kode berikut membuat objek target I/O dan membuka target dengan menentukan nama file.
UNICODE_STRING fileName;
RtlInitUnicodeString(
&fileName,
(PCWSTR)PROTOCOL_INTERFACE_NAME
);
status = WdfIoTargetCreate(
Adapter->WdfDevice,
WDF_NO_OBJECT_ATTRIBUTES,
&Adapter->IoTarget
);
if (!NT_SUCCESS(status)) {
DEBUGP(MP_ERROR, ("WdfIoTargetCreate failed 0x%x\n", status));
return status;
}
WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME(
&openParams,
&fileName,
STANDARD_RIGHTS_ALL
);
status = WdfIoTargetOpen(
Adapter->IoTarget,
&openParams
);
if (!NT_SUCCESS(status)) {
DEBUGP(MP_ERROR, ("WdfIoTargetOpen failed 0x%x\n", status));
return status;
}
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_INIT_EXISTING_DEVICE