Fungsi WdfIoResourceListCreate (wdfresource.h)

Artikel
02/27/2024

[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)

Lihat juga

WDF_OBJECT_ATTRIBUTES

Bagikan melalui