Funzione WdfChildListBeginIteration (wdfchildlist.h)

Articolo
02/26/2024

[Si applica solo a KMDF]

Il metodo WdfChildListBeginIteration prepara il framework per il recupero di elementi da un elenco figlio specificato.

Sintassi

void WdfChildListBeginIteration(
  [in] WDFCHILDLIST             ChildList,
  [in] PWDF_CHILD_LIST_ITERATOR Iterator
);

Parametri

[in] ChildList

Handle per un oggetto elenco figlio del framework.

[in] Iterator

Puntatore a una struttura WDF_CHILD_LIST_ITERATOR allocata dal chiamante che indica il tipo di dispositivi figlio da recuperare.

Valore restituito

nessuno

Osservazioni

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

Dopo aver chiamato WdfChildListBeginIteration, il driver può chiamare ripetutamente WdfChildListRetrieveNextDevice per ottenere informazioni su ogni dispositivo figlio nell'elenco figlio.

Al termine della chiamata al driver WdfChildListRetrieveNextDevice, deve chiamare WdfChildListEndIteration.

Se il driver apporta modifiche all'elenco figlio dopo aver chiamato WdfChildListBeginIteration, il framework archivia tutte le modifiche e notifica al gestore Plug and Play (PnP) delle modifiche quando il driver chiama WdfChildListEndIteration.

Il driver può annidare le chiamate a WdfChildListBeginIteration e WdfChildListEndIteration. Se il driver annida chiamate a questi metodi, il framework archivia tutte le modifiche fino all'ultima chiamata a WdfChildListEndIteration.

Per altre informazioni sugli elenchi figlio, vedere Enumerazione dinamica.

Esempio

Per un esempio di codice che usa WdfChildListBeginIteration, vedere WdfChildListRetrieveNextDevice.

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)