Metode IWDFDevice::CreateWdfFile (wudfddi.h)
[Peringatan: UMDF 2 adalah versi terbaru UMDF dan pengganti UMDF 1. Semua driver UMDF baru harus ditulis menggunakan UMDF 2. Tidak ada fitur baru yang ditambahkan ke UMDF 1 dan ada dukungan terbatas untuk UMDF 1 pada versi Windows 10 yang lebih baru. Driver Universal Windows harus menggunakan UMDF 2. Untuk informasi selengkapnya, lihat Mulai menggunakan UMDF.]
Metode CreateWdfFile membuat objek file untuk digunakan driver.
Sintaks
HRESULT CreateWdfFile(
[in, optional] LPCWSTR pcwszFileName,
[out] IWDFDriverCreatedFile **ppFile
);
Parameter
[in, optional] pcwszFileName
Penunjuk ke string yang dihentikan NULL yang berisi nama file untuk membuat objek file. Parameter ini bersifat opsional. Driver dapat melewati NULL jika driver tidak harus membuat objek file dari nama file. Jika driver harus memberikan nama, string yang dilewati driver tidak boleh berisi karakter pemisah jalur ("/" atau "\").
[out] ppFile
Penunjuk ke buffer yang menerima penunjuk ke antarmuka IWDFDriverCreatedFile untuk objek file yang dibuat driver.
Mengembalikan nilai
CreateWdfFile mengembalikan S_OK jika operasi berhasil. Jika tidak, metode ini mengembalikan salah satu kode kesalahan yang ditentukan dalam Winerror.h.
Keterangan
Untuk informasi tentang kapan driver UMDF menggunakan CreateWdfFile untuk menangani I/O, lihat Membuat Objek File untuk Menangani I/O.
Untuk informasi tentang kapan driver UMDF mungkin menggunakan CreateWdfFile untuk mencegah ketidakseimbangan membuat dan menutup pemberitahuan ke driver, lihat Mencegah Ketidakseimbangan Buat dan Tutup Pemberitahuan ke Driver.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Akhir dukungan | Tidak tersedia di UMDF 2.0 dan yang lebih baru. |
| Target Platform | Desktop |
| Versi UMDF minimum | 1,5 |
| Header | wudfddi.h (termasuk Wudfddi.h) |
| DLL | WUDFx.dll |