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
STATUS_INVALID_PARAMETER
 輸入參數無效。
STATUS_INVALID_DEVICE_REQUEST
 IdentificationDescription 指向的結構大小不正確。
STATUS_NO_SUCH_DEVICE
 子清單中找不到指定的裝置。
 

這個方法也可能傳回其他 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

WDF_CHILD_IDENTIFICATION_DESCRIPTION_HEADER_INIT

WdfChildListAddOrUpdateChildDescriptionAsPresent