WdfIoResourceListGetDescriptor-Funktion (wdfresource.h)
[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) |