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

Siehe auch

IO_RESOURCE_DESCRIPTOR

WdfIoResourceListUpdateDescriptor-