共用方式為


MINIPORT_DISABLE_INTERRUPT回呼函式 (ndis.h)

NDIS 可以呼叫迷你埠驅動程式的 MiniportDisableInterruptEx 處理程式,以停用診斷和疑難解答的中斷。

注意 您必須使用 MINIPORT_DISABLE_INTERRUPT 類型來宣告函式。 如需詳細資訊,請參閱下列範例一節。
 

語法

MINIPORT_DISABLE_INTERRUPT MiniportDisableInterrupt;

void MiniportDisableInterrupt(
  [in] NDIS_HANDLE MiniportInterruptContext
)
{...}

參數

[in] MiniportInterruptContext

內容信息的區塊句柄。 miniport 驅動程式在miniportInterruptContext 參數中提供這個句柄,而迷你埠驅動程式會傳遞至 NdisMRegisterInterruptEx 函式。

傳回值

沒有

言論

如果驅動程式呼叫 NdisMRegisterInterruptEx 函式來註冊中斷,迷你埠驅動程序必須提供 MiniportDisableInterruptEx 處理程式。

迷你埠驅動程序應該停用並啟用中斷,如 MiniportInterruptMiniportInterruptDpc 參考頁面中所述。

NDIS 會呼叫 MiniportEnableInterruptEx
MiniportDisableInterruptEx 函式,以啟用和停用診斷和疑難解答的中斷。 一般而言,MiniportEnableInterruptExMiniportDisableInterruptEx 存取 MiniportInterrupt 函式共用的迷你埠驅動程序資源。 因此,NDIS 會在 DIRQL 呼叫這些處理程式。

範例

若要定義 MiniportDisableInterruptEx 函式,您必須先提供可識別您所定義函式類型的函式宣告。 Windows 提供一組驅動程式的函式類型。 使用函式類型宣告函式有助於 驅動程式的程式代碼分析靜態驅動程序驗證器 (SDV)和其他驗證工具尋找錯誤,而且是撰寫 Windows作系統驅動程式的需求。

例如,若要定義名為 「MyDisableInterruptEx」 的 MiniportDisableInterruptEx 函式,請使用 MINIPORT_DISABLE_INTERRUPT 類型,如下列程式代碼範例所示:

MINIPORT_DISABLE_INTERRUPT MyDisableInterruptEx;

然後,實作您的函式,如下所示:

_Use_decl_annotations_
VOID
 MyDisableInterruptEx(
    NDIS_HANDLE  MiniportInterruptContext
    )
  {...}

MINIPORT_DISABLE_INTERRUPT 函式類型定義於 Ndis.h 頭檔中。 若要在執行程式代碼分析工具時更準確地識別錯誤,請務必將 Use_decl_annotations 批註新增至函式定義。 Use_decl_annotations 批注可確保在頭檔中套用至 MINIPORT_DISABLE_INTERRUPT 函式類型的批注。 如需函式宣告需求的詳細資訊,請參閱 使用 NDIS 驅動程式的函式角色類型來宣告函式

如需 Use_decl_annotations的相關信息,請參閱 批注函式行為

要求

要求 價值
最低支援的用戶端 NDIS 6.0 和更新版本支援。
目標平臺 窗戶
標頭 ndis.h (包括 Ndis.h)
IRQL 請參閱一節

另請參閱

MiniportEnableInterruptEx

MiniportInterrupt

MiniportInterruptDPC

NDIS_MINIPORT_INTERRUPT_CHARACTERISTICS

NdisMRegisterInterruptEx