Funzione WdfFdoLockStaticChildListForIteration (wdffdo.h)
[Si applica solo a KMDF]
Il metodo WdfFdoLockStaticChildListForIteration prepara il framework per il recupero di elementi dall'elenco figlio statico appartenente a un dispositivo padre specificato.
Sintassi
void WdfFdoLockStaticChildListForIteration(
[in] WDFDEVICE Fdo
);
Parametri
[in] Fdo
Handle per un oggetto dispositivo framework che rappresenta il dispositivo padre.
Valore restituito
nessuno
Osservazioni
Se il driver fornisce un handle di oggetto non valido, si verifica un controllo di bug.
I driver del bus che usano l'enumerazione bus statica possono chiamare WdfFdoLockStaticChildListForIteration.
Dopo aver chiamato WdfFdoLockStaticChildListForIteration, il driver può chiamare ripetutamente WdfFdoRetrieveNextStaticChild per ottenere informazioni su ogni dispositivo figlio nell'elenco figlio.
Al termine della chiamata di WdfFdoRetrieveNextStaticChild, il driver deve chiamare WdfFdoUnlockStaticChildListFromIteration.
Se il driver apporta modifiche all'elenco figlio dopo aver chiamato WdfFdoLockStaticChildListForIteration, il framework archivia tutte le modifiche e invia una notifica al responsabile Plug and Play (PnP) delle modifiche quando il driver chiama WdfFdoUnlockStaticChildListFromIteration.
Il driver può annidare le chiamate a WdfFdoLockStaticChildListForIteration e WdfFdoUnlockStaticChildListFromIteration. Se il driver annida le chiamate a questi metodi, il framework archivia tutte le modifiche fino all'ultima chiamata a WdfFdoUnlockStaticChildListFromIteration.
Per altre informazioni sugli elenchi figlio statici, vedere Enumerazione statica.
Esempio
Per un esempio di codice che usa WdfFdoLockStaticChildListForIteration, vedere WdfFdoRetrieveNextStaticChild.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Universale |
| Versione KMDF minima | 1.0 |
| Intestazione | wdffdo.h (include Wdf.h) |
| Libreria | Wdf01000.sys (vedere Controllo delle versioni della libreria framework). |
| IRQL | <= DISPATCH_LEVEL |
| Regole di conformità DDI | DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf) |