WdfCmResourceListGetDescriptor-Funktion (wdfresource.h)
[Gilt für KMDF und UMDF]
Die WdfCmResourceListGetDescriptor-Methode gibt einen Zeiger auf einen Ressourcendeskriptor zurück, der in einer angegebenen Ressourcenliste enthalten ist.
Syntax
PCM_PARTIAL_RESOURCE_DESCRIPTOR WdfCmResourceListGetDescriptor(
[in] WDFCMRESLIST List,
[in] ULONG Index
);
Parameter
[in] List
Ein Handle für ein Framework resource-list-Objekt, das eine Liste der Hardwareressourcen für ein Gerät darstellt.
[in] Index
Ein nullbasierter Wert, der als Index in der logischen Konfiguration verwendet wird, die List angibt.
Rückgabewert
WdfCmResourceListGetDescriptor gibt einen Zeiger auf die CM_PARTIAL_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 Ressourcendeskriptor, den WdfCmResourceListGetDescriptor abruft, nicht ändern.
Weitere Informationen zu Ressourcenlisten finden Sie unter Hardwareressourcen für Framework-Based Treiber.
Beispiele
Ein Codebeispiel, das WdfCmResourceListGetDescriptor verwendet, finden Sie unter WdfCmResourceListGetCount.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Universell |
| KMDF-Mindestversion | 1.0 |
| UMDF-Mindestversion | 2.0 |
| Kopfzeile | wdfresource.h (include Wdf.h) |
| Bibliothek | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |