Funzione WdfChildListBeginScan (wdfchildlist.h)

  • Articolo

[Si applica solo a KMDF]

Il metodo WdfChildListBeginScan prepara un elenco specificato di dispositivi figlio in modo che il driver possa aggiornare le informazioni nell'elenco.

Sintassi

void WdfChildListBeginScan(
  [in] WDFCHILDLIST ChildList
);

Parametri

[in] ChildList

Handle per un oggetto elenco figlio del framework.

Valore restituito

nessuno

Osservazioni

Un controllo di bug si verifica se il driver fornisce un handle di oggetti non valido.

Il metodo WdfChildListBeginScan contrassegna tutti i dispositivi figlio nell'elenco come mancante.

Dopo aver chiamato WdfChildListBeginScan, il driver può chiamare WdfChildListAddOrUpdateChildDescriptionAsPresent ripetutamente oppure chiamare ripetutamente WdfChildListUpdateAllChildDescriptionsAsPresent per segnalare tutti i dispositivi figlio attualmente collegati al dispositivo padre.

Al termine dell'aggiornamento dell'elenco figlio, il driver deve chiamare WdfChildListEndScan. Questa chiamata recapita l'elenco figlio aggiornato al gestore Plug and Play (PnP). Successivamente, il framework chiamerà la funzione di callback EvtChildListCreateDevice per ogni dispositivo segnalato dal driver.

Per altre informazioni sugli elenchi figlio, vedere Enumerazione dinamica.

Esempio

Per un esempio di codice che usa WdfChildListBeginScan, vedere WdfChildListAddOrUpdateChildDescriptionAsPresent.

Requisiti

Requisito Valore
Piattaforma di destinazione Universale
Versione KMDF minima 1.0
Intestazione wdfchildlist.h (includere Wdf.h)
Libreria Wdf01000.sys (vedere Framework Library Versioning).
IRQL <= DISPATCH_LEVEL
Regole di conformità DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Vedi anche

WdfChildListAddOrUpdateChildDescriptionAsPresent

WdfChildListBeginIteration

WdfChildListEndScan

WdfChildListUpdateAllChildDescriptionsAsPresent