Funzione WdfFdoGetDefaultChildList (wdffdo.h)

  • Articolo

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

Vedi anche

WdfFdoInitSetDefaultChildListConfig