Fungsi WdfDeviceAssignMofResourceName (wdfdevice.h)
[Berlaku untuk KMDF saja]
Metode WdfDeviceAssignMofResourceName mendaftarkan nama sumber daya MOF untuk perangkat tertentu.
Sintaks
NTSTATUS WdfDeviceAssignMofResourceName(
[in] WDFDEVICE Device,
[in] PCUNICODE_STRING MofResourceName
);
Parameter
[in] Device
Handel ke objek perangkat kerangka kerja.
[in] MofResourceName
Penunjuk ke struktur UNICODE_STRING yang menentukan nama sumber daya MOF.
Nilai kembali
Jika operasi berhasil, WdfDeviceAssignMofResourceName mengembalikan STATUS_SUCCESS. Nilai pengembalian tambahan meliputi:
Menampilkan kode | Deskripsi |
---|---|
|
Driver telah disebut WdfDeviceAssignMofResourceName. |
|
Memori tidak cukup tersedia. |
Metode ini mungkin mengembalikan nilai NTSTATUS lainnya.
Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.
Keterangan
Driver yang menyediakan file MOF untuk mendukung WMI harus memanggil fungsi panggilan balik WdfDeviceAssignMofResourceName, biasanya dari dalam fungsi panggilan balik EvtDriverDeviceAdd atau EvtDevicePrepareHardware . Nama sumber daya MOF adalah nama file yang ditentukan driver dalam pernyataan MofResource dalam file skrip sumber daya (RC). Untuk informasi selengkapnya tentang menentukan nama sumber daya MOF, lihat Mengkompilasi File MOF Driver.
Driver yang menghitung perangkat di bus dapat memanggil WdfDeviceAssignMofResourceName untuk perangkat induk, dan kerangka kerja akan menggunakan nama sumber daya MOF induk untuk perangkat anak.
Untuk informasi selengkapnya tentang WMI, lihat Mendukung WMI di driver Framework-Based.
Contoh
Contoh kode berikut mendeklarasikan string Unicode yang mewakili nama sumber daya MOF lalu mendaftarkan nama.
NTSTATUS status;
DECLARE_CONST_UNICODE_STRING(mofRsrcName, MOFRESOURCENAME);
status = WdfDeviceAssignMofResourceName(
Device,
&mofRsrcName
);
if (!NT_SUCCESS(status)) {
return status;
}
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Versi KMDF minimum | 1,0 |
Header | wdfdevice.h (termasuk Wdf.h) |
Pustaka | Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.) |
IRQL | PASSIVE_LEVEL |
Aturan kepatuhan DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk