WdfCmResourceListRemove-Funktion (wdfresource.h)
[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 zu einem Framework-Ressourcenlistenobjekt, 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
Nichts
Bemerkungen
Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.
Die WdfCmResourceListRemove -Methode entfernt den Ressourcendeskriptor, der dem Indexwert zugeordnet ist, den der Index Parameter angibt.
Wenn WdfCmResourceListRemove den Ressourcendeskriptor entfernt, der den Indexwert naufweist, ä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 Drivers.
Beispiele
Im folgenden Codebeispiel wird der dritte Ressourcendeskriptor aus den rohen und übersetzten Listen von Hardwareressourcen entfernt, die eine EvtDeviceRemoveAddedResources Rückruffunktion empfängt.
NTSTATUS
MyEvtDeviceRemoveAddedResources(
WDFDEVICE Device,
WDFCMRESLIST ResourcesRaw,
WDFCMRESLIST ResourcesTranslated
)
{
...
WdfCmResourceListRemove(
ResourcesRaw,
2
);
WdfCmResourceListRemove(
ResourcesTranslated,
2
);
...
}
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Minimale KMDF-Version | 1.0 |
| Header- | wdfresource.h (include Wdf.h) |
| Library | Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.) |
| IRQL- | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |