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 |