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 結構的指標。

傳回值

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

傳回碼 Description
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) 錯誤檢查。

當 DPC 在 IRQL= DISPATCH_LEVEL或更新版本上執行或叫用 DPC 時，必須呼叫 StorPortQueryDpcWatchdogInformation。 否則，呼叫會失敗並傳回STOR_STATUS_UNSUCCESSFUL。

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

規格需求

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

另請參閱

STOR_DPC_WATCHDOG_INFORMATION