Fungsi WdfCmResourceListGetDescriptor (wdfresource.h)

  • Artikel

[Berlaku untuk KMDF dan UMDF]

Metode WdfCmResourceListGetDescriptor mengembalikan penunjuk ke deskriptor sumber daya yang terkandung dalam daftar sumber daya tertentu.

Sintaks

PCM_PARTIAL_RESOURCE_DESCRIPTOR WdfCmResourceListGetDescriptor(
  [in] WDFCMRESLIST List,
  [in] ULONG        Index
);

Parameter

[in] List

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

[in] Index

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

Nilai kembali

WdfCmResourceListGetDescriptor mengembalikan penunjuk ke struktur CM_PARTIAL_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 deskriptor sumber daya yang diambil WdfCmResourceListGetDescriptor .

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

Contoh

Untuk contoh kode yang menggunakan WdfCmResourceListGetDescriptor, lihat WdfCmResourceListGetCount.

Persyaratan

Persyaratan Nilai
Target Platform Universal
Versi KMDF minimum 1,0
Versi UMDF minimum 2.0
Header wdfresource.h (termasuk Wdf.h)
Pustaka Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF)
IRQL <=DISPATCH_LEVEL
Aturan kepatuhan DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Lihat juga

CM_PARTIAL_RESOURCE_DESCRIPTOR