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

Siehe auch

CM_PARTIAL_RESOURCE_DESCRIPTOR