WdfChildListRequestChildEject 函式 （wdfchildlist.h）
[僅適用於 KMDF]
WdfChildListRequestChildEject 方法會通知架構指定的裝置即將從其停駐站中退出。
語法
BOOLEAN WdfChildListRequestChildEject(
[in] WDFCHILDLIST ChildList,
[in] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
);
參數
[in] ChildList
子清單物件的句柄。
[in] IdentificationDescription
呼叫端配置之 WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 結構的指標。
傳回值
如果作業成功，WdfChildListRequestChildEject 會傳回 true TRUE。 如果輸入參數無效，或架構在子清單中找不到裝置，此方法會傳回 FALSE。
如果驅動程式提供無效的物件句柄，就會發生系統錯誤檢查。
言論
總線驅動程式可以呼叫 WdfChildListRequestChildEject 或 WdfPdoRequestEject 來報告驅動程式偵測到嘗試從裝置停駐站中排除其中一個列舉子裝置的嘗試。 例如，驅動程式可能會偵測到使用者已按下退出按鈕。
如果驅動程式使用動態總線列舉，且裝置的識別描述可用，則驅動程式可以呼叫 WdfChildListRequestChildEject。 如果裝置 PDO 的架構裝置物件可用，驅動程式可以呼叫 WdfPdoRequestEject。
WdfChildListRequestChildEject 方法的 IdentificationDescription 參數會識別正在退出的裝置。 裝置必須是 child list 的成員，ChildList 參數所代表。
架構會使用識別描述，在子清單中找出裝置。
如需子清單的詳細資訊，請參閱 動態列舉。
如需可退出裝置的詳細資訊，請參閱 支援可退出裝置。
例子
如需使用 WdfChildListRequestChildEject的程式碼範例，請參閱 WdfChildListRetrieveNextDevice。
要求
| 要求 | 價值 |
|---|---|
| 目標平臺 | 普遍 |
| 最低 KMDF 版本 | 1.0 |
| 標頭 | wdfchildlist.h （包括 Wdf.h） |
| 連結庫 | Wdf01000.sys （請參閱架構連結庫版本控制。） |
| IRQL | <= DISPATCH_LEVEL |
| DDI 合規性規則 | DriverCreate（kmdf），KmdfIrql（kmdf），KmdfIrql2（kmdf），KmdfIrqlExplicit（kmdf） |