WdfCmResourceListGetDescriptor-Funktion (wdfresource.h)

  • Artikel

[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)

Weitere Informationen

CM_PARTIAL_RESOURCE_DESCRIPTOR