WdfChildListUpdateChildDescriptionAsMissing 函式 (wdfchildlist.h)
[僅適用於 KMDF]
WdfChildListUpdateChildDescriptionAsMissing 方法會通知架構指定的子裝置目前未叢集或無法使用。
語法
NTSTATUS WdfChildListUpdateChildDescriptionAsMissing(
[in] WDFCHILDLIST ChildList,
[in] PWDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER IdentificationDescription
);
參數
[in] ChildList
子清單物件的句柄。
[in] IdentificationDescription
呼叫端配置的 WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER 結構的指標，可識別驅動程式提供的子 識別描述。
傳回值
WdfChildListUpdateChildDescriptionAsMissing 會傳回STATUS_SUCCESS，如果作業成功， NT_SUCCESS () 狀態) 等於 TRUE 的另一個狀態值。 否則，此方法可能會傳回下列其中一個值：
| 傳回碼 | Description |
|---|---|
|
輸入參數無效。 |
|
IdentificationDescription 指向的結構大小不正確。 |
|
子清單中找不到指定的裝置。 |
這個方法也可能傳回其他 NTSTATUS值。
如果驅動程式提供無效的物件句柄，就會發生系統錯誤檢查。
備註
即使驅動程式從未呼叫 WdfChildListAddOrUpdateChildDescriptionAsPresent 來報告裝置存在，您的驅動程式仍可報告裝置無法使用。 在此情況下， WdfChildListUpdateChildDescriptionAsMissing 方法只會傳回STATUS_NO_SUCH_DEVICE。
如果您想要報告子清單中的所有裝置都無法使用，您的驅動程式可以直接呼叫 WdfChildListBeginScan，然後緊接著 WdfChildListEndScan，而不是為每個裝置呼叫 WdfChildListUpdateChildDescriptionAsMissing。
如需子裝置和子清單的詳細資訊，請參閱 動態列舉。
範例
下列程式代碼範例會通知架構具有指定序號的子裝置無法使用。
PDO_IDENTIFICATION_DESCRIPTION description;
NTSTATUS status;
WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT(
&description.Header,
sizeof(description)
);
description.SerialNo = SerialNo;
status = WdfChildListUpdateChildDescriptionAsMissing(
list,
&description.Header
);
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | 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