irqlExApcLte3 規則 (wdm)

  • 發行項

IrqlExApcLte3 規則指定驅動程式只會在 IRQL <= APC_LEVEL呼叫下列主管支援例程。

與 IRQL 相關的錯誤驅動程式可能會導致嚴重問題，而且可能會導致電腦當機。

驅動程式模型：WDM

此規則找到錯誤檢查 () ： 錯誤檢查0xC4：DRIVER_VERIFIER_DETECTED_VIOLATION (0x20007) 、 錯誤檢查0xA：IRQL_NOT_LESS_OR_EQUAL

範例

下列程式代碼違反此規則：

NTSTATUS
DispatchRequest (
    _In_ PDEVICE_REQUEST DeviceRequest
    )
{  
    KIRQL OldIrql;
    KSPIN_LOCK SpinLock;
    NTSTATUS Status;
    ...

    KeInitializeSpinLock(&SpinLock);

    //
    // KeAcquireSpinLock sets IRQL to DISPATCH_LEVEL and the previous IRQL is 
    // written to OldIrql after the lock is acquired.
    //

    KeAcquireSpinLock(&SpinLock, &OldIrql);
    ...

    Status = ProcessRequest(DeviceRequest);

    //
    // KeReleaseSpinLock sets IRQL to the OldIrql returned by KeAcquireSpinLock.
    //

    KeReleaseSpinLock(&SpinLock, &OldIrql);
    ...
}

NTSTATUS
ProcessRequest (
    _In_ PDEVICE_REQUEST DeviceRequest
    )
{
    ERESOURCE Resource;
    NTSTATUS Status;
    ...

    Resource = DeviceRequest->GetTableLock();

    //
    // RULE VIOLATION! - ExAcquireSharedStarveExclusive can be called only at 
    //                   IRQL <= APC_LEVEL. 
    //

    if(!ExAcquireSharedStarveExclusive(&Resource, FALSE)) {
        return STATUS_UNSUCCESSFUL;
    }

    ...

    ExReleaseResourceLite(&Resource);
    ...
    return Status;
}

測試方法

在編譯時期

執行 靜態驅動程式驗證器 並指定 IrqlExApcLte3 規則。

使用下列步驟來執行程式碼的分析：
  1. 準備程式代碼 (使用角色類型宣告) 。
  2. 執行靜態驅動程式驗證程式。
  3. 檢視和分析結果。

如需詳細資訊，請參閱 使用靜態驅動程式驗證器尋找驅動程式中的瑕疵。
运行时

執行 驅動程式驗證器 ，然後選取 [DDI 合規性檢查 ] 選項。

適用於

ExAcquireResourceExclusiveLiteExAcquireResourceSharedLiteExAcquireSharedStarveExclusiveExAcquireSharedWaitForExclusiveExConvertExclusiveToSharedLiteExDeleteResourceLite

另請參閱

管理使用微調鎖定時防止錯誤和死結的硬體優先順序