enumeração WDF_RETRIEVE_CHILD_FLAGS (wdfchildlist.h)

  • Artigo

[Aplica-se somente ao KMDF]

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

Syntax

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 apenas 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 a função de retorno de chamada EvtChildListCreateDevice do driver).
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.

Comentários

Antes de chamar WdfChildListBeginIteration, seu driver deve definir sinalizadores do tipo WDF_RETRIEVE_CHILD_FLAGS 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)

Confira também

EvtChildListCreateDevice

WDF_CHILD_LIST_ITERATOR

WdfChildListBeginIteration

WdfChildListRetrieveNextDevice