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 |