Freigeben über


WdfChildListBeginScan-Funktion (wdfchildlist.h)

[Gilt nur für KMDF]

Die WdfChildListBeginScan-Methode bereitet eine angegebene Liste von untergeordneten Geräten 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 Frameworklistenobjekt.

Rückgabewert

Keine

Bemerkungen

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

Die WdfChildListBeginScan-Methode markiert alle untergeordneten Geräte in der Liste als fehlend.

Nach dem Aufrufen von WdfChildListBeginScan kann der Treiber WdfChildListAddOrUpdateChildDescriptionAsPresent wiederholt aufrufen oder WdfChildListUpdateAllChildDescriptionsAsPresent aufrufen, 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. Mit diesem Aufruf wird die aktualisierte untergeordnete Liste an den PnP-Manager (Plug & Play) übermittelt. Anschließend ruft das Framework die EvtChildListCreateDevice-Rückruffunktion des Treibers für jedes Vom Treiber gemeldete Gerät auf.

Weitere Informationen zu untergeordneten Listen finden Sie unter Dynamische Enumeration.

Beispiele

Ein Codebeispiel, das WdfChildListBeginScan verwendet, finden Sie unter WdfChildListAddOrUpdateChildDescriptionAsPresent.

Anforderungen

Anforderung Wert
Zielplattform Universell
KMDF-Mindestversion 1.0
Kopfzeile wdfchildlist.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

WdfChildListAddOrUpdateChildDescriptionAsPresent

WdfChildListBeginIteration

WdfChildListEndScan

WdfChildListUpdateAllChildDescriptionsAsPresent