NDK_FN_CREATE_COMPLETION回呼函式（ndkpi.h）

發行項
02/07/2025

NdkCreateCompletion （NDK_FN_CREATE_COMPLETION）函式會完成 NDK 物件的建立。

語法

NDK_FN_CREATE_COMPLETION NdkFnCreateCompletion;

void NdkFnCreateCompletion(
  [in, optional] PVOID Context,
  [in]           NTSTATUS Status,
  [in]           NDK_OBJECT_HEADER *pNdkObject
)
{...}

參數

[in, optional] Context

取用者呼叫物件建立函式時傳遞至 NDK 提供者的內容值。建立函式會將異步建立完成要求提供給內容，NdkCreateCompletion （NDK_FN_CREATE_COMPLETION）函式指標。

[in] Status

建立要求的異步完成狀態。如需可針對每種物件類型傳回的完成狀態代碼，請參閱物件建立函式（例如，NDK_FN_CREATE_CQ）。

[in] pNdkObject

NDK 對象標頭的指標（NDK_OBJECT_HEADER）。

傳回值

沒有

言論

附注此函式是由 NDK 取用者實作，並傳遞至 NDK 提供者。

NDK 對像是使用異步函式建立的。這些異步物件建立函式會採用 NDK_FN_CREATE_COMPLETION 函式指標作為輸入參數。

NDK 提供者可以從異步物件建立函式傳回STATUS_PENDING。在此情況下，NDK 提供者必須呼叫建立完成函式，以指出物件建立已完成。

任何其他狀態代碼都表示內嵌完成。在此情況下，提供者不得呼叫建立要求完成函式。如果 create request 函式傳回STATUS_PENDING以外的NT_STATUS狀態代碼，則必須使用 create request 函式在輸出參數中傳回所建立的物件。

針對以異步方式傳回STATUS_PENDING和稍後完成STATUS_SUCCESS的建立要求，建立完成函式必須使用 pNdkObject 參數傳回建立物件，提供者不得存取 create request 函式的對象輸出參數。

要求

要求	價值
最低支援的用戶端	不支援，在 NDIS 6.30 和更新版本中支援。
支援的最低伺服器	Windows Server 2012
目標平臺	窗戶
標頭	ndkpi.h （包括 Ndkpi.h）
IRQL	<=DISPATCH_LEVEL