fungsi WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE (wdfiotarget.h)

Artikel
02/27/2024

[Hanya berlaku untuk UMDF]

Fungsi WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE menginisialisasi struktur WDF_IO_TARGET_OPEN_PARAMS driver sehingga driver dapat membuka target I/O dengan menentukan nama file.

Sintaks

void WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE(
  [out]          PWDF_IO_TARGET_OPEN_PARAMS Params,
  [in, optional] PCUNICODE_STRING           FileName
);

Parameter

[out] Params

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

[in, optional] FileName

Nilai untuk anggota FileName dari struktur WDF_IO_TARGET_OPEN_PARAMS . Sebagian besar driver menentukan NULL di sini kecuali target yang lebih rendah mendukung Akses Namespace Perangkat.

Nilai kembali

Tidak ada

Keterangan

Fungsi WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE nol struktur WDF_IO_TARGET_OPEN_PARAMS yang ditentukan dan menetapkan anggota Ukurannya . Ini juga mengatur anggota Jenis struktur ke WdfIoTargetOpenLocalTargetByFile dan mengatur anggota FileName jika driver memasok nama file.

Driver dapat secara eksplisit menutup target I/O dengan memanggil WdfIoTargetClose. Jika driver tidak secara eksplisit menutup target, kerangka kerja menutup target secara otomatis ketika perangkat dihapus (target I/O secara default diindukkan ke perangkat).

Contoh

Contoh kode berikut menunjukkan bagaimana driver UMDF dapat membuka target lokal dengan objek file seperti yang dijelaskan dalam WDF_IO_TARGET_OPEN_TYPE:

WDF_OBJECT_ATTRIBUTES  ioTargetAttrib;
WDFIOTARGET  ioTarget;
WDF_IO_TARGET_OPEN_PARAMS  openParams;

//
// Create target
//
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&ioTargetAttrib, TARGET_DEVICE_INFO);
status = WdfIoTargetCreate(device, &ioTargetAttrib, &ioTarget);
if (!NT_SUCCESS(status)) {
    return status;
}

//
// Open target
//
WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE(&openParams, NULL);
status = WdfIoTargetOpen(ioTarget, &openParams);
if (!NT_SUCCESS(status)) {
    WdfObjectDelete(ioTarget);
    return status;
}

//
// create a request
//


//
// Format the request for the above target
//


//
// Send request to above target
//

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 8.1
Target Platform	Universal
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_TYPE

Bagikan melalui