fungsi WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME (wdfiotarget.h)

Artikel
02/27/2024

[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;
}