EVT_WDF_CHILD_LIST_SCAN_FOR_CHILDREN função de retorno de chamada (wdfchildlist.h)

  • Artigo

[Aplica-se somente ao KMDF]

A função de retorno de chamada de evento EvtChildListScanForChildren de um driver deve relatar todos os dispositivos filho presentes.

Sintaxe

EVT_WDF_CHILD_LIST_SCAN_FOR_CHILDREN EvtWdfChildListScanForChildren;

void EvtWdfChildListScanForChildren(
  [in] WDFCHILDLIST ChildList
)
{...}

Parâmetros

[in] ChildList

Um identificador para um objeto de lista filho da estrutura.

Retornar valor

Nenhum

Comentários

Se um driver de barramento estiver usando enumeração dinâmica, ele poderá registrar uma função de retorno de chamada EvtChildListScanForChildren chamando WdfFdoInitSetDefaultChildListConfig ou WdfChildListCreate.

Se um driver fornecer uma função de retorno de chamada EvtChildListScanForChildren , a estrutura a chamará sempre que o dispositivo pai entrar no estado de trabalho (D0). (Para obter mais informações sobre quando essa função de retorno de chamada é chamada, consulte Cenários de gerenciamento de energia e PnP.)

O driver deve relatar todos os seus dispositivos filho fazendo o seguinte:

  1. Chamar WdfChildListBeginScan, que marca todos os dispositivos filho relatados anteriormente como ausentes.
  2. Detectando dispositivos filho e chamando WdfChildListAddOrUpdateChildDescriptionAsPresent para cada dispositivo detectado.
  3. Chamar WdfChildListEndScan, que informa o gerenciador PnP dos dispositivos filho relatados.
Para obter mais informações sobre enumeração dinâmica, consulte Enumerando os dispositivos em um barramento.

A função de retorno de chamada EvtChildListScanForChildren é chamada em IRQL = PASSIVE_LEVEL. Você não deve tornar essa função de retorno de chamada paginável.

Requisitos

Requisito Valor
Plataforma de Destino Universal
Versão mínima do KMDF 1.0
Cabeçalho wdfchildlist.h (inclua Wdf.h)
IRQL PASSIVE_LEVEL (consulte a seção Comentários)

Confira também

WdfChildListAddOrUpdateChildDescriptionAsPresent

WdfChildListBeginScan

WdfChildListCreate

WdfChildListEndScan

WdfFdoInitSetDefaultChildListConfig