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)

另請參閱

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER

WdfPdoRequestEject