Fungsi WdfIoResourceListCreate (wdfresource.h)
[Berlaku untuk KMDF saja]
Metode WdfIoResourceListCreate membuat konfigurasi logis kosong, yang dapat diisi dan ditambahkan ke daftar persyaratan sumber daya.
Sintaks
NTSTATUS WdfIoResourceListCreate(
[in] WDFIORESREQLIST RequirementsList,
[in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
[out] WDFIORESLIST *ResourceList
);
Parameter
[in] RequirementsList
Handel ke objek daftar persyaratan sumber daya kerangka kerja yang mewakili daftar persyaratan sumber daya perangkat.
[in, optional] Attributes
Penunjuk ke struktur WDF_OBJECT_ATTRIBUTES yang dialokasikan pemanggil yang berisi atribut untuk objek baru. (Anggota ParentObject struktur harus NULL.) Parameter ini bersifat opsional dan dapat WDF_NO_OBJECT_ATTRIBUTES.
[out] ResourceList
Handel ke objek daftar rentang sumber daya kerangka kerja yang mewakili konfigurasi logis baru.
Nilai kembali
WdfIoResourceListCreate mengembalikan STATUS_SUCCESS jika operasi berhasil.
Untuk nilai pengembalian tambahan, lihat Kesalahan Pembuatan Objek Kerangka Kerja.
Pemeriksaan bug sistem terjadi jika driver memasok handel objek yang tidak valid.
Keterangan
Untuk informasi selengkapnya tentang daftar persyaratan sumber daya dan konfigurasi logis, lihat Sumber Daya Perangkat Keras untuk Driver Framework-Based.
Objek daftar persyaratan sumber daya yang ditentukan pemanggil menjadi induk objek daftar rentang sumber daya baru. Driver tidak dapat mengubah induk ini, dan anggota ParentObject atau struktur WDF_OBJECT_ATTRIBUTES harus NULL.
Contoh
Untuk contoh kode yang menggunakan WdfIoResourceListCreate, lihat WdfIoResourceRequirementsListAppendIoResList.
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Versi KMDF minimum | 1,0 |
Header | wdfresource.h (termasuk Wdf.h) |
Pustaka | Wdf01000.sys (lihat Penerapan Versi Pustaka Kerangka Kerja.) |
IRQL | <=DISPATCH_LEVEL |
Aturan kepatuhan DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |