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 zu einem Framework-Ressourcenlistenobjekt, 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 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 Ressourcendeskriptor nicht ändern, der WdfCmResourceListGetDescriptor abruft.
Weitere Informationen zu Ressourcenlisten finden Sie unter Hardwareressourcen für Framework-Based Drivers.
Beispiele
Ein Codebeispiel, das WdfCmResourceListGetDescriptor-verwendet, finden Sie unter WdfCmResourceListGetCount.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Universal |
| Minimale KMDF-Version | 1.0 |
| Mindest-UMDF-Version | 2.0 |
| Header- | wdfresource.h (include Wdf.h) |
| Library | Wdf01000.sys (KMDF); WUDFx02000.dll (UMDF) |
| IRQL- | <=DISPATCH_LEVEL |
| DDI-Complianceregeln | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |