Função WdfFdoGetDefaultChildList (wdffdo.h)

[Aplica-se somente ao KMDF]

O método WdfFdoGetDefaultChildList retorna um identificador para a lista filho padrão de um dispositivo especificado.

Sintaxe

WDFCHILDLIST WdfFdoGetDefaultChildList(
  [in] WDFDEVICE Fdo
);

Parâmetros

[in] Fdo

Um identificador para um objeto de dispositivo de estrutura.

Retornar valor

Se a operação for bem-sucedida, WdfFdoGetDefaultChildList retornará um identificador para a lista filho padrão associada ao dispositivo especificado pelo Fdo. Caso contrário, o método retornará NULL.

Um bug do sistema marcar ocorrerá se o driver fornecer um identificador de objeto inválido.

Comentários

Antes de chamar WdfFdoGetDefaultChildList, seu driver deve chamar WdfFdoInitSetDefaultChildListConfig para configurar a lista filho padrão. Caso contrário, WdfFdoGetDefaultChildList retornará NULL.

Para obter mais informações sobre listas filho, consulte Enumeração dinâmica.

Exemplos

O exemplo de código a seguir obtém um identificador para a lista filho padrão de um dispositivo.

WDFCHILDLIST  list;

list = WdfFdoGetDefaultChildList(Device);

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Cabeçalho wdffdo.h (include Wdf.h)
Biblioteca Wdf01000.sys (consulte Controle de versão da biblioteca de estrutura.)
IRQL <= DISPATCH_LEVEL
Regras de conformidade da DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Confira também

WdfFdoInitSetDefaultChildListConfig