Funzione WdfFdoLockStaticChildListForIteration (wdffdo.h)

  • Articolo

[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)

Vedi anche

WdfFdoUnlockStaticChildListFromIteration