EVT_WDF_CHILD_LIST_SCAN_FOR_CHILDREN funzione di callback (wdfchildlist.h)

[Si applica solo a KMDF]

La funzione di callback dell'evento EvtChildListScanForChildren di un driver deve segnalare tutti i dispositivi figlio presenti.

Sintassi

EVT_WDF_CHILD_LIST_SCAN_FOR_CHILDREN EvtWdfChildListScanForChildren;

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

Parametri

[in] ChildList

Handle per un oggetto elenco figlio del framework.

Valore restituito

nessuno

Osservazioni

Se un driver del bus usa enumerazione dinamica, può registrare una funzione di callback EvtChildListScanForChildren chiamando WdfFdoInitSetDefaultChildListConfig o WdfChildListCreate.

Se un driver fornisce una funzione di callback EvtChildListScanForChildren , il framework lo chiama ogni volta che il dispositivo padre entra nello stato di lavoro (D0). Per altre informazioni su quando viene chiamata questa funzione di callback, vedere Scenari di PnP e Power Management.

Il driver deve segnalare tutti i dispositivi figlio eseguendo le operazioni seguenti:

1. Chiamata di WdfChildListBeginScan, che contrassegna tutti i dispositivi figlio segnalati in precedenza come mancanti.
2. Rilevamento di dispositivi figlio e chiamata di WdfChildListAddOrUpdateChildDescriptionAsPresent per ogni dispositivo rilevato.
3. Chiamata di WdfChildListEndScan, che informa il gestore PnP dei dispositivi figlio segnalati.

Per altre informazioni sull'enumerazione dinamica, vedere Enumerazione dei dispositivi in un bus.

La funzione di callback EvtChildListScanForChildren viene chiamata in IRQL = PASSIVE_LEVEL. Non è consigliabile rendere questa funzione di callback paginabile.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Universale
Versione KMDF minima	1.0
Intestazione	wdfchildlist.h (includere Wdf.h)
IRQL	PASSIVE_LEVEL (vedere la sezione Osservazioni)

Vedi anche

WdfChildListAddOrUpdateChildDescriptionAsPresent

WdfChildListBeginScan

WdfChildListCreate

WdfChildListEndScan

WdfFdoInitSetDefaultChildListConfig