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 Ressourcenanforderungslisteenthalten ist.
Syntax
PIO_RESOURCE_DESCRIPTOR WdfIoResourceListGetDescriptor(
[in] WDFIORESLIST ResourceList,
[in] ULONG Index
);
Parameter
[in] ResourceList
Ein Handle zu einem Framework-Ressourcenbereichslistenobjekt, 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 Index Parameter 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.
Bemerkungen
Der Treiber kann den Inhalt der IO_RESOURCE_DESCRIPTOR Struktur, die WdfIoResourceListGetDescript or abruft, nicht ändern. Um einen Ressourcendeskriptor zu ändern, kann der Treiber WdfIoResourceListUpdateDescriptoraufrufen.
Weitere Informationen zu Ressourcenanforderungenlisten und logischen Konfigurationen finden Sie unter Hardwareressourcen für Framework-Based Drivers.
Beispiele
Ein Codebeispiel, das WdfIoResourceListGetDescriptor-verwendet, finden Sie unter WdfIoResourceRequirementsListGetIoResList.
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) |