共用方式為

EXPAND_STACK_CALLOUT回呼函式 (ntddk.h)

  • 發行項

ExpandedStackCall 例程會以保證的堆疊大小執行。

語法

EXPAND_STACK_CALLOUT ExpandStackCallout;

VOID() ExpandStackCallout(
  [in, optional] PVOID Parameter
)
{...}

參數

[in, optional] Parameter

傳遞至執行 ExpandedStackCall 之 KeExpandKernelStackAndCallout 例程的值。

傳回值

無

備註

ExpandedStackCall 例程必須處理所有例外狀況。 任何未處理的例外狀況都會讓系統使用 錯誤檢查0x1E進行錯誤檢查：KMODE_EXCEPTION_NOT_HANDLED。

如果 ExpandedStackCall 變更目前的 IRQL，它必須先還原原始值，才能傳回。

範例

若要定義 ExpandedStackCall 回呼例程，您必須先提供函式宣告來識別您要定義的回呼例程類型。 Windows 提供一組驅動程式的回呼函式類型。 使用回呼函式類型宣告函式有助於 驅動程式的程式代碼分析、 靜態驅動程式驗證器 (SDV) ，以及其他驗證工具會尋找錯誤，而且這是撰寫 Windows 操作系統驅動程式的需求。

例如，若要定義名為MyExpandedStackCall的 ExpandedStackCall 回呼例程，請使用 EXPAND_STACK_CALLOUT 類型，如下列程式代碼範例所示：

EXPAND_STACK_CALLOUT MyExpandedStackCall;

然後，實作回呼例程，如下所示：

_Use_decl_annotations_
VOID
  MyExpandedStackCall(
    PVOID  Parameter
    )
  {
      // Function body
  }

EXPAND_STACK_CALLOUT函式類型定義於 Wdm.h 頭檔中。 若要在執行程式代碼分析工具時更精確地識別錯誤，請務必將 _Use_decl_annotations_ 註釋新增至函式定義。 批 _Use_decl_annotations_ 注可確保使用頭檔中套用至EXPAND_STACK_CALLOUT函式類型的批注。 如需函式宣告需求的詳細資訊，請參閱 使用WDM驅動程式的函式角色類型來宣告函式。 如需 的相關信息 _Use_decl_annotations_，請參閱 標註函式行為。

規格需求

需求 值
目標平台 桌面
標頭 ntddk.h (包含 Ntddk.h、Ntifs.h)

另請參閱

KeExpandKernelStackAndCallout