EVT_WDF_CHILD_LIST_SCAN_FOR_CHILDREN回呼函式 (wdfchildlist.h)

  • 發行項

[僅適用於 KMDF]

驅動程式的 EvtChildListScanForChildren 事件回呼函式必須報告所有存在的子裝置。

語法

EVT_WDF_CHILD_LIST_SCAN_FOR_CHILDREN EvtWdfChildListScanForChildren;

void EvtWdfChildListScanForChildren(
  [in] WDFCHILDLIST ChildList
)
{...}

參數

[in] ChildList

架構子清單物件的句柄。

傳回值

無

備註

如果總線驅動程式使用動態列舉，它可以藉由呼叫 WdfFdoInitSetDefaultChildListConfig 或 WdfChildListCreate 來註冊 EvtChildListScanForChildren 回呼函式。

如果驅動程式提供 EvtChildListScanForChildren 回呼函式，則架構會在每次父裝置進入其運作 (D0) 狀態時呼叫它。 (如需呼叫此回呼函式時的詳細資訊，請參閱 PnP 和電源管理案例。)

驅動程式必須執行下列動作來報告其所有子裝置：

  1. 呼叫 WdfChildListBeginScan，這會將所有先前回報的子裝置標示為遺漏。
  2. 偵測子裝置，並針對每個偵測到的裝置呼叫 WdfChildListAddOrUpdateChildDescriptionAsPresent 。
  3. 呼叫 WdfChildListEndScan，通知 PnP 管理員回報的子裝置。
如需動態列舉的詳細資訊，請參閱 列舉總線上的裝置。

EvtChildListScanForChildren 回呼函式是在 IRQL = PASSIVE_LEVEL呼叫。 您不應該讓此回呼函 式可分頁。

規格需求

需求 值
目標平台 Universal
最低 KMDF 版本 1.0
標頭 wdfchildlist.h (包含 Wdf.h)
IRQL PASSIVE_LEVEL (请参阅一节)

另請參閱

WdfChildListAddOrUpdateChildDescriptionAsPresent

WdfChildListBeginScan

WdfChildListCreate

WdfChildListEndScan

WdfFdoInitSetDefaultChildListConfig