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。 如果輸入參數無效，或架構在子清單中找不到裝置，此方法會傳回 FALSE。
如果驅動程式提供無效的物件句柄，就會發生系統錯誤檢查。
備註
總線驅動程式可以呼叫 WdfChildListRequestChildEject 或 WdfPdoRequestEject 來報告驅動程式已偵測到嘗試從裝置停駐站退出其中一個列舉的子裝置。 例如，驅動程式可能會偵測到使用者已按下退出按鈕。
如果驅動程式使用動態總線列舉，而且裝置的識別描述可用，驅動程式可以呼叫 WdfChildListRequestChildEject。 如果可用的裝置 PDO 架構裝置對象，驅動程式可以呼叫 WdfPdoRequestEject。
WdfChildListRequestChildEject 方法的 IdentificationDescription 參數會識別退出的裝置。 裝置必須是 ChildList 參數所代表子清單的成員。
架構會使用識別描述，在子清單中尋找裝置。
如需子清單的詳細資訊，請參閱 動態列舉。
如需可退出裝置的詳細資訊，請參閱 支援退出的裝置。
範例
如需使用 WdfChildListRequestChildEject 的程式代碼範例，請參閱 WdfChildListRetrieveNextDevice。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 最小 KMDF 版本 | 1.0 |
| 標頭 | wdfchildlist.h (包含 Wdf.h) |
| 程式庫 | Wdf01000.sys (請參閱 Framework Library Versioning.) |
| IRQL | <= DISPATCH_LEVEL |
| DDI 合規性規則 | DriverCreate (kmdf) 、 KmdfIrql (kmdf) 、 KmdfIrql2 (kmdf) 、 KmdfIrqlExplicit (kmdf) |