WdfChildListBeginScan-Funktion (wdfchildlist.h)

[Gilt nur für KMDF]

Die WdfChildListBeginScan--Methode bereitet eine angegebene Liste untergeordneter Geräte vor, damit der Treiber die Informationen in der Liste aktualisieren kann.

Syntax

VOID WdfChildListBeginScan(
  [in] WDFCHILDLIST ChildList
);

Parameter

[in] ChildList

Ein Handle für ein untergeordnetes Listenobjekt des Frameworks.

Rückgabewert

Nichts

Bemerkungen

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

Die WdfChildListBeginScan--Methode kennzeichnet alle untergeordneten Geräte in der Liste als fehlt.

Nach dem Aufrufen WdfChildListBeginScankann der Treiber WdfChildListAddOrUpdateChildDescriptionAsPresent wiederholt aufrufen oder WdfChildListUpdateAllChildDescriptionsAsPresentaufrufen, um alle untergeordneten Geräte zu melden, die derzeit an das übergeordnete Gerät angefügt sind.

Nachdem der Treiber die Aktualisierung der untergeordneten Liste abgeschlossen hat, muss er WdfChildListEndScan-aufrufen. Dieser Aufruf übermittelt die aktualisierte untergeordnete Liste an den Plug and Play(PnP)-Manager. Anschließend ruft das Framework die EvtChildListCreateDevice Rückruffunktion für jedes Gerät auf, das der Treiber gemeldet hat.

Weitere Informationen zu untergeordneten Listen finden Sie unter dynamische Enumeration.

Beispiele

Ein Codebeispiel, das WdfChildListBeginScanverwendet, finden Sie unter WdfChildListAddOrUpdateChildDescriptionAsPresent.

Anforderungen

Siehe auch

WdfChildListAddOrUpdateChildDescriptionAsPresent

WdfChildListBeginIteration

WdfChildListEndScan-

WdfChildListUpdateAllChildDescriptionsAsPresent