Fungsi WdfIoResourceListGetDescriptor (wdfresource.h)

[Berlaku untuk KMDF saja]

Metode WdfIoResourceListGetDescriptor mengembalikan penunjuk ke deskriptor sumber daya yang terkandung dalam konfigurasi logis daftar persyaratan sumber daya.

Sintaks

PIO_RESOURCE_DESCRIPTOR WdfIoResourceListGetDescriptor(
  [in] WDFIORESLIST ResourceList,
  [in] ULONG        Index
);

Parameter

[in] ResourceList

Handel ke objek daftar rentang sumber daya kerangka kerja yang mewakili konfigurasi logis sumber daya perangkat keras untuk perangkat.

[in] Index

Nilai berbasis nol yang digunakan sebagai indeks ke dalam konfigurasi logis yang ditentukan ResourceList .

Nilai kembali

WdfIoResourceListGetDescriptor mengembalikan penunjuk ke struktur IO_RESOURCE_DESCRIPTOR yang menjelaskan sumber daya perangkat keras yang diidentifikasi parameter Indeks , jika nilai indeks valid. Jika tidak, metode mengembalikan NULL.

Pemeriksaan bug sistem terjadi jika driver memasok handel objek yang tidak valid.

Keterangan

Driver Anda tidak dapat mengubah konten struktur IO_RESOURCE_DESCRIPTOR yang diambil WdfIoResourceListGetDescriptor . Untuk mengubah deskriptor sumber daya, driver dapat memanggil WdfIoResourceListUpdateDescriptor.

Untuk informasi selengkapnya tentang daftar persyaratan sumber daya dan konfigurasi logis, lihat Sumber Daya Perangkat Keras untuk Driver Framework-Based.

Contoh

Untuk contoh kode yang menggunakan WdfIoResourceListGetDescriptor, lihat WdfIoResourceRequirementsListGetIoResList.

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

IO_RESOURCE_DESCRIPTOR

WdfIoResourceListUpdateDescriptor