Fungsi WdfCmResourceListRemove (wdfresource.h)

Artikel
02/27/2024

[Berlaku untuk KMDF saja]

Metode WdfCmResourceListRemove menghapus deskriptor sumber daya dari daftar sumber daya tertentu.

Sintaks

void WdfCmResourceListRemove(
  [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 daftar sumber daya yang ditentukan Daftar .

Nilai kembali

Tidak ada

Keterangan

Pemeriksaan bug terjadi jika driver menyediakan handel objek yang tidak valid.

Metode WdfCmResourceListRemove menghapus deskriptor sumber daya yang terkait dengan nilai indeks yang ditentukan parameter Indeks .

Ketika WdfCmResourceListRemove menghapus deskriptor sumber daya yang memiliki nilai indeks n, nilai indeks deskriptor sumber daya berikutnya berubah dari n+1 ke n.

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

Contoh

Contoh kode berikut menghapus deskriptor sumber daya ketiga dari daftar mentah dan terjemahan sumber daya perangkat keras yang diterima fungsi panggilan balik EvtDeviceRemoveAddedResources .

NTSTATUS
MyEvtDeviceRemoveAddedResources(
    WDFDEVICE Device,
    WDFCMRESLIST ResourcesRaw,
    WDFCMRESLIST ResourcesTranslated
    )
{
...
    WdfCmResourceListRemove(
                            ResourcesRaw,
                            2
                            );
    WdfCmResourceListRemove(
                            ResourcesTranslated,
                            2
                            );
...

}

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

WdfCmResourceListRemoveByDescriptor

Bagikan melalui