WdfFdoLockStaticChildListForIteration-Funktion (wdffdo.h)

[Gilt nur für KMDF]

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

Syntax

VOID WdfFdoLockStaticChildListForIteration(
  [in] WDFDEVICE Fdo
);

Die Parameter

[in] Fdo

Ein Handle zu einem Framework-Geräteobjekt, das das übergeordnete Gerät darstellt.

Rückgabewert

Nichts

Bemerkungen

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

Bustreiber, die statische Busenumeration verwenden, können WdfFdoLockStaticChildListForIterationaufrufen.

Nach dem Aufrufen WdfFdoLockStaticChildListForIterationkann der Treiber wiederholt WdfFdoRetrieveNextStaticChild aufrufen, um Informationen zu jedem untergeordneten Gerät in der untergeordneten Liste abzurufen.

Nachdem der Treiber WdfFdoRetrieveNextStaticChildaufgerufen hat, muss er WdfFdoUnlockStaticChildListFromIterationaufrufen.

Wenn der Treiber änderungen an der untergeordneten Liste vorgibt, nachdem WdfFdoLockStaticChildListForIterationaufgerufen wurde, speichert das Framework alle Änderungen und benachrichtigt den Plug and Play-Manager (PnP) über die Änderungen, wenn der Treiber WdfFdoUnlockStaticChildListFromIterationaufruft.

Der Treiber kann Aufrufe an WdfFdoLockStaticChildListForIteration und WdfFdoUnlockStaticChildListFromIterationverschachteln. Wenn der Treiber Aufrufe dieser Methoden schachtelt, speichert das Framework alle Änderungen bis zum letzten Aufruf von WdfFdoUnlockStaticChildListFromIteration.

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

Beispiele

Ein Codebeispiel, das WdfFdoLockStaticChildListForIterationverwendet, finden Sie unter WdfFdoRetrieveNextStaticChild.

Anforderungen

Siehe auch

WdfFdoUnlockStaticChildListFromIteration