enumerazione WDF_RETRIEVE_CHILD_FLAGS (wdfchildlist.h)

Articolo
03/05/2024

[Si applica solo a KMDF]

L'enumerazione WDF_RETRIEVE_CHILD_FLAGS definisce i flag che un driver può impostare prima di chiamare WdfChildListBeginIteration.

Sintassi

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;

Costanti


`WdfRetrieveUnspecified` Valore: 0x0000 Riservato esclusivamente per uso interno.
`WdfRetrievePresentChildren` Valore: 0x0001 Le chiamate a WdfChildListRetrieveNextDevice recupereranno i dispositivi figlio per i quali esiste un oggetto dispositivo framework.
`WdfRetrieveMissingChildren` Valore: 0x0002 Le chiamate a WdfChildListRetrieveNextDevice recupereranno i dispositivi figlio contrassegnati come mancanti.
`WdfRetrievePendingChildren` Valore: 0x0004 Le chiamate a WdfChildListRetrieveNextDevice recupereranno i dispositivi figlio segnalati dal driver come presenti, ma per cui non è stato creato un oggetto dispositivo framework (perché il framework non ha chiamato la funzione di callback EvtChildListCreateDevice del driver).
`WdfRetrieveAddedChildren` Valore: (WdfRetrievePresentChildren Le chiamate a WdfChildListRetrieveNextDevice recupereranno i dispositivi figlio presenti o in sospeso.
`WdfRetrieveAllChildren` Valore: (WdfRetrievePresentChildren Le chiamate a WdfChildListRetrieveNextDevice recupereranno i dispositivi figlio presenti, in sospeso o mancanti.

Commenti

Prima di chiamare WdfChildListBeginIteration, il driver deve impostare flag tipizzato WDF_RETRIEVE_CHILD_FLAGS in una struttura di WDF_CHILD_LIST_ITERATOR .

Requisiti

Requisito	Valore
Versione KMDF minima	1,0
Intestazione	wdfchildlist.h (include Wdf.h)

Vedi anche

EvtChildListCreateDevice

WDF_CHILD_LIST_ITERATOR

WdfChildListBeginIteration

WdfChildListRetrieveNextDevice

Condividi tramite