Compartilhar via


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.

Valor de retorno

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

Uma verificação de bugs do sistema ocorre se o driver fornece um identificador de objeto inválido.

Observações

Antes de chamar WdfFdoGetDefaultChildList, o driver deve chamar WdfFdoInitSetDefaultChildListConfig para configurar a lista filho padrão. Caso contrário, WdfFdoGetDefaultChildList retorna 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
da Plataforma de Destino Universal
versão mínima do KMDF 1.0
cabeçalho wdffdo.h (inclua Wdf.h)
Biblioteca Wdf01000.sys (consulte o Controle de Versão da Biblioteca da Estrutura.)
IRQL <= DISPATCH_LEVEL
regras de conformidade de DDI DriverCreate(kmdf), KmdfIrql(kmdf), KmdfIrql2(kmdf), KmdfIrqlExplicit(kmdf)

Consulte também

WdfFdoInitSetDefaultChildListConfig