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) |