WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS enumeration (wdfchildlist.h)

[Applies to KMDF only]

The WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS enumeration defines device status values that the framework stores in a driver's WDF_CHILD_RETRIEVE_INFO structure.

Syntax

typedef enum _WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS {
  WdfChildListRetrieveDeviceUndefined = 0,
  WdfChildListRetrieveDeviceSuccess,
  WdfChildListRetrieveDeviceNotYetCreated,
  WdfChildListRetrieveDeviceNoSuchDevice
} WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS, *PWDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS;

Constants

 
WdfChildListRetrieveDeviceUndefined
Value: 0
WdfChildListRetrieveDeviceSuccess
The WdfChildListRetrieveNextDevice or WdfChildListRetrievePdo method successfully retrieved a child device, and a framework device object exists for the device.
WdfChildListRetrieveDeviceNotYetCreated
WdfChildListRetrieveNextDevice or WdfChildListRetrievePdo successfully retrieved a child device, but a framework device object has not been created for the device (because the framework has not called the driver's EvtChildListCreateDevice callback function).
WdfChildListRetrieveDeviceNoSuchDevice
WdfChildListRetrieveNextDevice or WdfChildListRetrievePdo was not able to retrieve a child device that matched the search criteria.

Remarks

The WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS enumeration is used to specify the Status member of a WDF_CHILD_RETRIEVE_INFO structure.

Requirements

Requirement Value
Minimum KMDF version 1.0
Header wdfchildlist.h (include Wdf.h)

See also

EvtChildListCreateDevice

WDF_CHILD_RETRIEVE_INFO

WdfChildListRetrieveNextDevice

WdfChildListRetrievePdo