WdfIoResourceListCreate-Funktion (wdfresource.h)
[Gilt nur für KMDF]
Die WdfIoResourceListCreate-Methode erstellt eine leere logische Konfiguration, die aufgefüllt und einer Ressourcenanforderungsliste hinzugefügt werden kann.
Syntax
NTSTATUS WdfIoResourceListCreate(
[in] WDFIORESREQLIST RequirementsList,
[in, optional] PWDF_OBJECT_ATTRIBUTES Attributes,
[out] WDFIORESLIST *ResourceList
);
Parameter
[in] RequirementsList
Ein Handle für ein Framework-Ressourcenanforderungen-Listenobjekt, das die Ressourcenanforderungensliste eines Geräts darstellt.
[in, optional] Attributes
Ein Zeiger auf eine vom Aufrufer zugewiesene WDF_OBJECT_ATTRIBUTES Struktur, die Attribute für das neue Objekt enthält. (Das ParentObject-Element der Struktur muss NULL-sein.) Dieser Parameter ist optional und kann WDF_NO_OBJECT_ATTRIBUTES werden.
[out] ResourceList
Ein Handle für ein Framework-Ressourcenbereichslistenobjekt, das die neue logische Konfiguration darstellt.
Rückgabewert
WdfIoResourceListCreate gibt STATUS_SUCCESS zurück, wenn der Vorgang erfolgreich ist.
Weitere Rückgabewerte finden Sie unter Framework Object Creation Errors.
Eine Systemfehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Bemerkungen
Weitere Informationen zu Ressourcenanforderungenlisten und logischen Konfigurationen finden Sie unter Hardwareressourcen für Framework-Based Drivers.
Das vom Aufrufer angegebene Ressourcenanforderungen-Listenobjekt wird zum übergeordneten Objekt des neuen Ressourcenbereichslistenobjekts. Der Treiber kann dieses übergeordnete Element nicht ändern, und das ParentObject-Element oder die WDF_OBJECT_ATTRIBUTES Struktur muss NULL-sein.
Beispiele
Ein Codebeispiel, das WdfIoResourceListCreateverwendet, finden Sie unter WdfIoResourceRequirementsListAppendIoResList.
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) |