wdfchildlist.h 標頭

wdf 會使用此標頭。 如需詳細資訊，請參閱

• Windows 驅動程式架構

wdfchildlist.h 包含下列程式設計介面：

函式

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT WDF_CHILD_ADDRESS_DESCRIPTION_HEADER_INIT函式會初始化 WDF_CHILD_ADDRESS_DESCRIPTION_HEADER 結構。
WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT函式會初始化WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER結構。
WDF_CHILD_LIST_CONFIG_INIT WDF_CHILD_LIST_CONFIG_INIT函式會初始化WDF_CHILD_LIST_CONFIG結構。
WDF_CHILD_LIST_ITERATOR_INIT WDF_CHILD_LIST_ITERATOR_INIT函式會初始化WDF_CHILD_LIST_ITERATOR結構。
WDF_CHILD_RETRIEVE_INFO_INIT WDF_CHILD_RETRIEVE_INFO_INIT函式會初始化 WDF_CHILD_RETRIEVE_INFO 結構。
WdfChildListAddOrUpdateChildDescriptionAsPresent WdfChildListAddOrUpdateChildDescriptionAsPresent 方法會將新的子描述新增至子系列表，或更新現有的子描述。
WdfChildListBeginIteration WdfChildListBeginIteration 方法會準備架構，以從指定的子清單擷取專案。
WdfChildListBeginScan WdfChildListBeginScan 方法會準備指定的子裝置清單，讓驅動程式可以更新清單中的資訊。
WdfChildListCreate WdfChildListCreate 方法會為指定的父裝置建立子清單。
WdfChildListEndIteration WdfChildListEndIteration 方法會處理對指定子清單的修改。
WdfChildListEndScan WdfChildListEndScan 方法會處理對指定子清單的修改。
WdfChildListGetDevice WdfChildListGetDevice 方法會傳回架構裝置物件的控制碼，代表指定子清單的父裝置。
WdfChildListRequestChildEject WdfChildListRequestChildEject 方法會通知架構指定的裝置即將從其停駐站退出。
WdfChildListRetrieveAddressDescription WdfChildListRetrieveAddressDescription 方法會找出具有指定識別碼描述的子裝置，並擷取裝置的位址描述。
WdfChildListRetrieveNextDevice WdfChildListRetrieveNextDevice 方法會周遊指定的子清單，並擷取符合指定準則的下一個子裝置。
WdfChildListRetrievePdo WdfChildListRetrievePdo 方法會傳回與子清單中指定子描述相關聯的架構裝置物件控制碼。
WdfChildListUpdateAllChildDescriptionsAsPresent WdfChildListUpdateAllChildDescriptionsAsPresent 方法會通知架構，指定子清單中的所有子裝置都已插入且可用。
WdfChildListUpdateChildDescriptionAsMissing WdfChildListUpdateChildDescriptionAsMissing 方法會通知架構指定的子裝置目前未叢集或無法使用。

回呼函式

EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_CLEANUP 驅動程式的 EvtChildListAddressDescriptionCleanup 事件回呼函式會釋放驅動程式 EvtChildListAddressDescriptionDuplicate 回呼函式配置的任何記憶體配置。
EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_COPY 驅動程式的 EvtChildListAddressDescriptionCopy 事件回呼函式會將子位址描述從一個指定的位置複製到另一個位置。
EVT_WDF_CHILD_LIST_ADDRESS_DESCRIPTION_DUPLICATE 驅動程式的 EvtChildListAddressDescriptionDuplicate 事件回呼函式會複製子位址描述。
EVT_WDF_CHILD_LIST_CREATE_DEVICE 匯流排驅動程式的EvtChildListCreateDevice 事件回呼函式會為已動態列舉的新裝置建立架構裝置物件。
EVT_WDF_CHILD_LIST_DEVICE_REENUMERATED 驅動程式的 EvtChildListDeviceReenumerated 事件回呼函式可讓驅動程式核准或取消指定裝置的繼續。
EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_CLEANUP 驅動程式的 EvtChildListIdentificationDescriptionCleanup 事件回呼函式會釋放驅動程式的 EvtChildListIdentificationDescriptionDuplicate 回呼函式配置的任何記憶體配置。
EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COMPARE 驅動程式的 EvtChildListIdentificationDescriptionCompare 事件回呼函式會比較一個子識別描述與另一個子識別描述。
EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_COPY 驅動程式的 EvtChildListIdentificationDescriptionCopy 事件回呼函式會將子識別描述從一個指定的位置複製到另一個位置。
EVT_WDF_CHILD_LIST_IDENTIFICATION_DESCRIPTION_DUPLICATE 驅動程式的 EvtChildListIdentificationDescriptionDuplicate 事件回呼函式會複製子識別描述。
EVT_WDF_CHILD_LIST_SCAN_FOR_CHILDREN 驅動程式的 EvtChildListScanForChildren 事件回呼函式必須報告所有存在的子裝置。

結構

WDF_CHILD_ADDRESS_DESCRIPTION_HEADER WDF_CHILD_ADDRESS_DESCRIPTION_HEADER 結構是標頭結構，必須是每個位址描述結構的第一個成員。
WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 結構是標頭結構，必須是每個識別描述結構的第一個成員。
WDF_CHILD_LIST_CONFIG WDF_CHILD_LIST_CONFIG 結構包含子裝置清單的組態資訊。
WDF_CHILD_LIST_ITERATOR WDF_CHILD_LIST_ITERATOR 結構可識別當驅動程式呼叫 WdfChildListRetrieveNextDevice 時，架構將擷取的子裝置類型。
WDF_CHILD_RETRIEVE_INFO WDF_CHILD_RETRIEVE_INFO 結構包含呼叫 WdfChildListRetrieveNextDevice 或 WdfChildListRetrievePdo 取得之子裝置的相關資訊。

列舉

WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS WDF_CHILD_LIST_RETRIEVE_DEVICE_STATUS列舉會定義架構儲存在驅動程式WDF_CHILD_RETRIEVE_INFO結構中的裝置狀態值。
WDF_RETRIEVE_CHILD_FLAGS WDF_RETRIEVE_CHILD_FLAGS列舉會定義驅動程式在呼叫 WdfChildListBeginIteration 之前可以設定的旗標。