WdfIoResourceListCreate-Funktion (wdfresource.h)

  • Artikel

[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)

Weitere Informationen

WDF_OBJECT_ATTRIBUTES