enumeración WDF_RETRIEVE_CHILD_FLAGS (wdfchildlist.h)

  • Artículo

[Solo se aplica a KMDF]

La enumeración WDF_RETRIEVE_CHILD_FLAGS define marcas que un controlador puede establecer antes de llamar a 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 para uso interno.
WdfRetrievePresentChildren
Valor: 0x0001
Las llamadas a WdfChildListRetrieveNextDevice recuperarán los dispositivos secundarios para los que existe un objeto de dispositivo de marco.
WdfRetrieveMissingChildren
Valor: 0x0002
Las llamadas a WdfChildListRetrieveNextDevice recuperarán los dispositivos secundarios marcados como ausentes.
WdfRetrievePendingChildren
Valor: 0x0004
Las llamadas a WdfChildListRetrieveNextDevice recuperarán los dispositivos secundarios que el controlador ha notificado como presente, pero para los que no se ha creado un objeto de dispositivo de marco (porque el marco no ha llamado a la función de devolución de llamada EvtChildListCreateDevice del controlador).
WdfRetrieveAddedChildren
Valor: (WdfRetrievePresentChildren)
Las llamadas a WdfChildListRetrieveNextDevice recuperarán los dispositivos secundarios que están presentes o pendientes.
WdfRetrieveAllChildren
Valor: (WdfRetrievePresentChildren)
Las llamadas a WdfChildListRetrieveNextDevice recuperarán los dispositivos secundarios que están presentes, pendientes o que faltan.

Comentarios

Antes de llamar a WdfChildListBeginIteration, el controlador debe establecer marcas con tipo WDF_RETRIEVE_CHILD_FLAGS en una estructura de WDF_CHILD_LIST_ITERATOR .

Requisitos

Requisito Value
Versión mínima de KMDF 1.0
Encabezado wdfchildlist.h (incluya Wdf.h)

Consulte también

EvtChildListCreateDevice

WDF_CHILD_LIST_ITERATOR

WdfChildListBeginIteration

WdfChildListRetrieveNextDevice