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 |