EVT_WDF_CHILD_LIST_SCAN_FOR_CHILDREN Rückruffunktion (wdfchildlist.h)

Artikel
02/29/2024

[Gilt nur für KMDF]

Die EvtChildListScanForChildren-Ereignisrückruffunktion eines Treibers muss alle vorhandenen untergeordneten Geräte melden.

Syntax

EVT_WDF_CHILD_LIST_SCAN_FOR_CHILDREN EvtWdfChildListScanForChildren;

void EvtWdfChildListScanForChildren(
  [in] WDFCHILDLIST ChildList
)
{...}

Parameter

[in] ChildList

Ein Handle für ein untergeordnetes Listenobjekt des Frameworks.

Rückgabewert

Keine

Bemerkungen

Wenn ein Bustreiber eine dynamische Enumeration verwendet, kann er eine EvtChildListScanForChildren-Rückruffunktion registrieren, indem er WdfFdoInitSetDefaultChildListConfig oder WdfChildListCreate aufruft.

Wenn ein Treiber eine EvtChildListScanForChildren-Rückruffunktion bereitstellt, ruft das Framework sie jedes Mal auf, wenn das übergeordnete Gerät in den Arbeitszustand (D0) wechselt. (Weitere Informationen dazu, wann diese Rückruffunktion aufgerufen wird, finden Sie unter PnP- und Energieverwaltungsszenarien.)

Der Treiber muss alle untergeordneten Geräte wie folgt melden:

Aufrufen von WdfChildListBeginScan, der alle zuvor gemeldeten untergeordneten Geräte als fehlend markiert.
Erkennen untergeordneter Geräte und Aufrufen von WdfChildListAddOrUpdateChildDescriptionAsPresent für jedes erkannte Gerät.
Aufrufen von WdfChildListEndScan, der den PnP-Manager über die gemeldeten untergeordneten Geräte informiert.

Weitere Informationen zur dynamischen Enumeration finden Sie unter Auflisten der Geräte in einem Bus.

Die Rückruffunktion EvtChildListScanForChildren wird unter IRQL = PASSIVE_LEVEL aufgerufen. Sie sollten diese Rückruffunktion nicht auslagerungsfähig machen.