Fungsi WdfIoResourceRequirementsListRemove (wdfresource.h)

  • Artikel

[Berlaku untuk KMDF saja]

Metode WdfIoResourceRequirementsListRemove menghapus konfigurasi logis dari daftar persyaratan sumber daya.

Sintaks

void WdfIoResourceRequirementsListRemove(
  [in] WDFIORESREQLIST RequirementsList,
  [in] ULONG           Index
);

Parameter

[in] RequirementsList

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

[in] Index

Nilai berbasis nol yang digunakan sebagai indeks ke dalam daftar persyaratan sumber daya yang ditentukan RequirementsList .

Nilai kembali

Tidak ada

Keterangan

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

Metode WdfIoResourceRequirementsListRemove menghapus konfigurasi logis yang terkait dengan nilai indeks yang ditentukan parameter Indeks .

Ketika WdfIoResourceRequirementsListRemove menghapus konfigurasi logis yang memiliki nilai indeks n, nilai indeks konfigurasi logis berikutnya berubah dari n+1 ke n.

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

Contoh

Contoh kode berikut menghapus konfigurasi logis kedua dari daftar persyaratan sumber daya.

NTSTATUS
Example_EvtDeviceFilterRemoveResourceRequirements(
    IN WDFDEVICE Device,
    IN WDFIORESREQLIST RequirementsList
    )
{
...
    WdfIoResourceRequirementsListRemove(
                                        RequirementsList,
                                        1
                                        );
...
}

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

WdfIoResourceRequirementsListRemoveByIoResList