WdfFdoLockStaticChildListForIteration-Funktion (wdffdo.h)

  • Artikel

[Gilt nur für KMDF]

Die WdfFdoLockStaticChildListForIteration-Methode bereitet das Framework für das Abrufen von Elementen aus der statischen untergeordneten Liste vor, die zu einem angegebenen übergeordneten Gerät gehört.

Syntax

void WdfFdoLockStaticChildListForIteration(
  [in] WDFDEVICE Fdo
);

Parameter

[in] Fdo

Ein Handle für ein Frameworkgeräteobjekt, das das übergeordnete Gerät darstellt.

Rückgabewert

Keine

Bemerkungen

Eine Fehlerüberprüfung tritt auf, wenn der Treiber ein ungültiges Objekthandle bereitstellt.

Bustreiber, die die statische Busaufzählung verwenden, können WdfFdoLockStaticChildListForIteration aufrufen.

Nach dem Aufruf von WdfFdoLockStaticChildListForIteration kann der Treiber WdfFdoRetrieveNextStaticChild wiederholt aufrufen, um Informationen zu jedem untergeordneten Gerät in der untergeordneten Liste abzurufen.

Nachdem der Treiber den Aufruf von WdfFdoRetrieveNextStaticChild abgeschlossen hat, muss er WdfFdoUnlockStaticChildListFromIteration aufrufen.

Wenn der Treiber nach dem Aufruf von WdfFdoLockStaticChildListForIteration Änderungen an der untergeordneten Liste vornimmt, speichert das Framework alle Änderungen und benachrichtigt den PnP-Manager (Plug & Play) über die Änderungen, wenn der Treiber WdfFdoUnlockStaticChildListFromIteration aufruft.

Der Treiber kann Aufrufe von WdfFdoLockStaticChildListForIteration und WdfFdoUnlockStaticChildListFromIteration schachteln. Wenn der Treiber diese Methoden verschachtelt, speichert das Framework alle Änderungen bis zum letzten Aufruf von WdfFdoUnlockStaticChildListFromIteration.

Weitere Informationen zu statischen untergeordneten Listen finden Sie unter Statische Enumeration.

Beispiele

Ein Codebeispiel, das WdfFdoLockStaticChildListForIteration verwendet, finden Sie unter WdfFdoRetrieveNextStaticChild.

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
Kopfzeile wdffdo.h (einschließen von Wdf.h)
Bibliothek Wdf01000.sys (siehe Versionierung der Frameworkbibliothek.)
IRQL <= DISPATCH_LEVEL
DDI-Complianceregeln DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Weitere Informationen

WdfFdoUnlockStaticChildListFromIteration