WdfChildListBeginIteration-Funktion (wdfchildlist.h)

[Gilt nur für KMDF]

Die WdfChildListBeginIteration--Methode bereitet das Framework zum Abrufen von Elementen aus einer angegebenen untergeordneten Liste vor.

Syntax

VOID WdfChildListBeginIteration(
  [in] WDFCHILDLIST             ChildList,
  [in] PWDF_CHILD_LIST_ITERATOR Iterator
);

Parameter

[in] ChildList

Ein Handle für ein untergeordnetes Listenobjekt des Frameworks.

[in] Iterator

Ein Zeiger auf eine vom Aufrufer zugewiesene WDF_CHILD_LIST_ITERATOR Struktur, die den Typ der abzurufenden untergeordneten Geräte angibt.

Rückgabewert

Nichts

Bemerkungen

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

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

Nachdem der Treiber den Aufruf WdfChildListRetrieveNextDeviceabgeschlossen hat, muss er WdfChildListEndIterationaufrufen.

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

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

Weitere Informationen zu untergeordneten Listen finden Sie unter dynamische Enumeration.

Beispiele

Ein Codebeispiel, das WdfChildListBeginIterationverwendet, finden Sie unter WdfChildListRetrieveNextDevice.

Anforderungen

Siehe auch

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WDF_CHILD_LIST_ITERATOR

WDF_CHILD_LIST_ITERATOR_INIT

WdfChildListBeginScan-

WdfChildListEndIteration

WdfChildListRequestChildEject

WdfChildListRetrieveNextDevice