enumeração WDF_RETRIEVE_CHILD_FLAGS (wdfchildlist.h)

Artigo
02/07/2025

[Aplica-se somente ao KMDF]

A enumeração WDF_RETRIEVE_CHILD_FLAGS define sinalizadores que um driver pode definir antes de chamar WdfChildListBeginIteration.

Sintaxe

typedef enum _WDF_RETRIEVE_CHILD_FLAGS {
  WdfRetrieveUnspecified = 0x0000,
  WdfRetrievePresentChildren = 0x0001,
  WdfRetrieveMissingChildren = 0x0002,
  WdfRetrievePendingChildren = 0x0004,
  WdfRetrieveAddedChildren = (WdfRetrievePresentChildren | WdfRetrievePendingChildren),
  WdfRetrieveAllChildren = (WdfRetrievePresentChildren | WdfRetrievePendingChildren | WdfRetrieveMissingChildren)
} WDF_RETRIEVE_CHILD_FLAGS;

Constantes


`WdfRetrieveUnspecified` Valor: 0x0000 Reservado somente para uso interno.
`WdfRetrievePresentChildren` Valor: 0x0001 As chamadas para WdfChildListRetrieveNextDevice recuperarão dispositivos filho para os quais existe um objeto de dispositivo de estrutura.
`WdfRetrieveMissingChildren` Valor: 0x0002 As chamadas para WdfChildListRetrieveNextDevice recuperarão dispositivos filho marcados como ausentes.
`WdfRetrievePendingChildren` Valor: 0x0004 As chamadas para WdfChildListRetrieveNextDevice recuperarão dispositivos filho que o driver relatou como presentes, mas para os quais um objeto de dispositivo de estrutura não foi criado (porque a estrutura não chamou o do driver EvtChildListCreateDevice função de retorno de chamada).
`WdfRetrieveAddedChildren` Valor: (WdfRetrievePresentChildren As chamadas para WdfChildListRetrieveNextDevice recuperarão dispositivos filho que estão presentes ou pendentes.
`WdfRetrieveAllChildren` Valor: (WdfRetrievePresentChildren As chamadas para WdfChildListRetrieveNextDevice recuperarão dispositivos filho que estão presentes, pendentes ou ausentes.

Observações

Antes de chamar WdfChildListBeginIteration, seu driver deve definir sinalizadores WDF_RETRIEVE_CHILD_FLAGSdigitado em uma estrutura WDF_CHILD_LIST_ITERATOR.

Requisitos

Requisito	Valor
versão mínima do KMDF	1.0
cabeçalho	wdfchildlist.h (inclua Wdf.h)

Consulte também

EvtChildListCreateDevice

WDF_CHILD_LIST_ITERATOR

WdfChildListBeginIteration

WdfChildListRetrieveNextDevice

Compartilhar via