WdfIoResourceListUpdateDescriptor-Funktion (wdfresource.h)

Artikel
02/07/2025

[Gilt nur für KMDF]

Die WdfIoResourceListUpdateDescriptor Methode aktualisiert einen Ressourcendeskriptor in der logischen Konfigurationeiner Ressourcenanforderungenliste.

Syntax

void WdfIoResourceListUpdateDescriptor(
  [in] WDFIORESLIST            ResourceList,
  [in] PIO_RESOURCE_DESCRIPTOR Descriptor,
  [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] Descriptor

Ein Zeiger auf eine IO_RESOURCE_DESCRIPTOR Struktur, die eine Hardwareressource beschreibt.

[in] Index

Ein nullbasierter Wert, der als Index in der Gruppe von Ressourcendeskriptoren verwendet wird, die sich bereits in der logischen Konfiguration befinden, die ResourceList- angibt.

Rückgabewert

Nichts

Bemerkungen

Wenn der Treiber ein ungültiges Objekthandle bereitstellt, tritt eine Fehlerüberprüfung auf.

Die WdfIoResourceListUpdateDescriptor- Methode sucht den Ressourcendeskriptor, den der Index Parameter identifiziert. Anschließend kopiert die Methode den Ressourcendeskriptor, den der Descriptor Parameter angibt, in den Deskriptor, der Index- angibt.

Weitere Informationen zu Ressourcenanforderungenlisten und logischen Konfigurationen finden Sie unter Hardwareressourcen für Framework-Based Drivers.

Beispiele

Im folgenden Codebeispiel wird ein neuer Ressourcendeskriptor initialisiert und anschließend WdfIoResourceListUpdateDescriptor aufgerufen, um den zweiten Deskriptor in einer logischen Konfiguration durch den neuen Deskriptor zu ersetzen.

IO_RESOURCE_DESCRIPTOR newDescriptor;

RtlZeroMemory(
              &newDescriptor,
              sizeof(newDescriptor)
              );

newDescriptor.Option = 0;
newDescriptor.Type = CmResourceTypePort;
newDescriptor.ShareDisposition = CmResourceShareDeviceExclusive;
newDescriptor.Flags = CM_RESOURCE_PORT_IO|CM_RESOURCE_PORT_16_BIT_DECODE;
newDescriptor.u.Port.Length = 1;
newDescriptor.u.Port.Alignment = 0x01;
newDescriptor.u.Port.MinimumAddress.QuadPart = 0;
newDescriptor.u.Port.MaximumAddress.QuadPart = 0xFFFF;

WdfIoResourceListUpdateDescriptor(
                                  Reslist,
                                  &newDescriptor,
                                  1
                                  );

Anforderungen

Anforderung	Wert
Zielplattform-	Universal
Minimale KMDF-Version	1.0
Header-	wdfresource.h (include Wdf.h)
Library	Wdf01000.sys (siehe Framework-Bibliotheksversionsverwaltung.)
IRQL-	<=DISPATCH_LEVEL
DDI-Complianceregeln	DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Siehe auch

IO_RESOURCE_DESCRIPTOR

Freigeben über