WdfIoResourceListCreate-Funktion (wdfresource.h)
[Gilt nur für KMDF]
Die WdfIoResourceListCreate-Methode erstellt eine leere logische Konfiguration, die aufgefüllt und einer Liste der Ressourcenanforderungen 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 resource-requirements-list-Objekt, das die Ressourcenanforderungsliste eines Geräts darstellt.
[in, optional] Attributes
Ein Zeiger auf eine vom Aufrufer zugeordnete 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-Objekt resource-range-list, 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 Fehler beim Erstellen von Frameworkobjekten.
Eine Systemfehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.
Hinweise
Weitere Informationen zu Ressourcenanforderungslisten und logischen Konfigurationen finden Sie unter Hardwareressourcen für Framework-Based Treiber.
Das vom Aufrufer angegebene resource-requirements-list-Objekt wird das übergeordnete Objekt des neuen resource-range-list-Objekts. 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 WdfIoResourceListCreate verwendet, finden Sie unter WdfIoResourceRequirementsListAppendIoResList.
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) |