共用方式為


StorPortQueryDpcWatchdogInformation 函式 (storport.h)

StorPortQueryDpcWatchdogInformation 查詢目前處理器的 DPC 監視程式定時器值。

語法

ULONG StorPortQueryDpcWatchdogInformation(
  [in]  PVOID                          HwDeviceExtension,
  [out] PSTOR_DPC_WATCHDOG_INFORMATION DpcWatchdogInformation
);

參數

[in] HwDeviceExtension

迷你埠裝置延伸模組的指標。

[out] DpcWatchdogInformation

將寫入 DPC 監視程式資訊之 STOR_DPC_WATCHDOG_INFORMATION 結構的指標。

傳回值

此函式會傳回下列其中一個狀態代碼。

傳回碼 描述
STOR_STATUS_SUCCESS 已成功查詢 DPC 監視程序資訊。
STOR_STATUS_INVALID_PARAMETER 參數無效;例如,DpcWatchdogInformation 為 NULL。
STOR_STATUS_UNSUCCESSFUL 基於其他內部系統原因傳回。

言論

迷你埠可以在 IRQL=DISPATCH_LEVEL 呼叫 StorPortQueryDpcWatchdogInformation,以判斷發生延遲過程調用 (DPC) 逾時之前所保留的時間量。 作系統會實作 DPC 監視程式定時器,以偵測單一 DPC 例程執行的時間太長,或當一系列佇列的 DPC 例程回溯執行太久時。 如果啟用 DPC 逾時錯誤,而且 DPC 例程超過單一例程的時間限制,或一系列 DPC 例程超過匯總時間限制,就會發生 DPC_WATCHDOG_VIOLATION (0x133) 錯誤檢查。

StorPortQueryDpcWatchdogInformation 必須在目前處理器的 IRQL= DISPATCH_LEVEL 或更新版本執行或叫用 DPC 時呼叫。 否則,呼叫會失敗並傳回STOR_STATUS_UNSUCCESSFUL。

DPC 例程應該只執行短暫的期間,而且應該儘可能將處理委派給背景工作線程。 為了避免系統回應性降低,每次呼叫系統時,一般 DPC 例程應該執行不超過 100 毫秒。 如需一般資訊,請參閱撰寫 DPC 例程 指導方針。

要求

要求 價值
支援的最低伺服器 Windows Server 2022
標頭 storport.h
IRQL DISPATCH_LEVEL

另請參閱

STOR_DPC_WATCHDOG_INFORMATION