WdfCmResourceListRemove-Funktion (wdfresource.h)

  • Artikel

[Gilt nur für KMDF]

Die WdfCmResourceListRemove-Methode entfernt einen Ressourcendeskriptor aus einer angegebenen Ressourcenliste.

Syntax

void WdfCmResourceListRemove(
  [in] WDFCMRESLIST List,
  [in] ULONG        Index
);

Parameter

[in] List

Ein Handle für ein Framework resource-list-Objekt, das eine Liste der Hardwareressourcen für ein Gerät darstellt.

[in] Index

Ein nullbasierter Wert, der als Index in der Ressourcenliste verwendet wird, die List angibt.

Rückgabewert

Keine

Bemerkungen

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Die WdfCmResourceListRemove-Methode entfernt den Ressourcendeskriptor, der dem Indexwert zugeordnet ist, den der Indexparameter angibt.

Wenn WdfCmResourceListRemove den Ressourcendeskriptor entfernt, der den Indexwert n aufweist, ändert sich der Indexwert des nächsten Ressourcendeskriptors von n+1 in n.

Weitere Informationen zu Ressourcenlisten finden Sie unter Hardwareressourcen für Framework-Based Treiber.

Beispiele

Im folgenden Codebeispiel wird der dritte Ressourcendeskriptor aus den unformatierten und übersetzten Listen der Hardwareressourcen entfernt, die von einer EvtDeviceRemoveAddedResources-Rückruffunktion empfangen werden.

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

}

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
Kopfzeile wdfresource.h (include Wdf.h)
Bibliothek Wdf01000.sys (siehe Versionsverwaltung der Frameworkbibliothek).)
IRQL <=DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

WdfCmResourceListRemoveByDescriptor