Funzione WdfFdoGetDefaultChildList (wdffdo.h)
[Si applica solo a KMDF]
Il metodo WdfFdoGetDefaultChildList restituisce un handle all'elenco figlio predefinito di un dispositivo specificato.
Sintassi
WDFCHILDLIST WdfFdoGetDefaultChildList(
[in] WDFDEVICE Fdo
);
Parametri
[in] Fdo
Handle per un oggetto dispositivo framework.
Valore restituito
Se l'operazione ha esito positivo, WdfFdoGetDefaultChildList restituisce un handle all'elenco figlio predefinito associato al dispositivo specificato da Fdo. In caso contrario, il metodo restituisce NULL.
Un controllo dei bug di sistema si verifica se il driver fornisce un handle di oggetto non valido.
Commenti
Prima di chiamare WdfFdoGetDefaultChildList, il driver deve chiamare WdfFdoInitSetDefaultChildListConfig per configurare l'elenco figlio predefinito. In caso contrario, WdfFdoGetDefaultChildList restituisce NULL.
Per altre informazioni sugli elenchi figlio, vedere Enumerazione dinamica.
Esempio
Nell'esempio di codice seguente viene ottenuto un handle per l'elenco figlio predefinito di un dispositivo.
WDFCHILDLIST list;
list = WdfFdoGetDefaultChildList(Device);
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) |