WdfIoResourceListGetDescriptor-Funktion (wdfresource.h)

  • Artikel

[Gilt nur für KMDF]

Die WdfIoResourceListGetDescriptor-Methode gibt einen Zeiger auf einen Ressourcendeskriptor zurück, der in der logischen Konfiguration einer Ressourcenanforderungsliste enthalten ist.

Syntax

PIO_RESOURCE_DESCRIPTOR WdfIoResourceListGetDescriptor(
  [in] WDFIORESLIST ResourceList,
  [in] ULONG        Index
);

Parameter

[in] ResourceList

Ein Handle für ein Framework resource-range-list-Objekt, das eine logische Konfiguration von Hardwareressourcen für ein Gerät darstellt.

[in] Index

Ein nullbasierter Wert, der als Index in der logischen Konfiguration verwendet wird, die ResourceList angibt.

Rückgabewert

WdfIoResourceListGetDescriptor gibt einen Zeiger auf die IO_RESOURCE_DESCRIPTOR-Struktur zurück, die die Hardwareressource beschreibt, die der Indexparameter identifiziert, wenn der Indexwert gültig ist. Andernfalls gibt die Methode NULL zurück.

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

Hinweise

Der Treiber kann den Inhalt der IO_RESOURCE_DESCRIPTOR Struktur, die WdfIoResourceListGetDescriptor abruft, nicht ändern. Um einen Ressourcendeskriptor zu ändern, kann der Treiber WdfIoResourceListUpdateDescriptor aufrufen.

Weitere Informationen zu Ressourcenanforderungslisten und logischen Konfigurationen finden Sie unter Hardwareressourcen für Framework-Based Treiber.

Beispiele

Ein Codebeispiel, das WdfIoResourceListGetDescriptor verwendet, finden Sie unter WdfIoResourceRequirementsListGetIoResList.

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

IO_RESOURCE_DESCRIPTOR

WdfIoResourceListUpdateDescriptor