NDK_FN_CLOSE_OBJECT回呼函式（ndkpi.h）

發行項
02/07/2025

NdkCloseObject （NDK_FN_CLOSE_OBJECT）函式會起始 NDK 物件的關閉要求。

語法

NDK_FN_CLOSE_OBJECT NdkFnCloseObject;

NTSTATUS NdkFnCloseObject(
  [in]           NDK_OBJECT_HEADER *pNdkObject,
  [in]           NDK_FN_CLOSE_COMPLETION CloseCompletion,
  [in, optional] PVOID RequestContext
)
{...}

參數

[in] pNdkObject

要關閉之對象標頭的指標（NDK_OBJECT_HEADER）。

[in] CloseCompletion

NdkCloseCompletion 的指標， 關閉完成回呼函式（NDK_FN_CLOSE_COMPLETION）。

[in, optional] RequestContext

要傳回 NdkCloseCompletion 函式的 NDK 提供者內容值，該函式是在 CloseCompletion 參數中指定的。

傳回值

NdkCloseObject 函式會傳回下列其中一個 NTSTATUS 程式代碼。

傳回碼	描述
STATUS_SUCCESS	NDK 物件已關閉。提供者不會呼叫 NdkCloseCompletion 函式。
STATUS_PENDING	要求擱置中，提供者會呼叫 NdkCloseCompletion 函式，以異步方式完成作業。關閉要求已成功起始，但可能尚未完成。
其他狀態代碼	發生錯誤。

言論

每個NDK物件的函式分派數據表包含 NDK_FN_CLOSE_OBJECT 函式指標。關閉要求是異步的。啟動關閉要求之後，NDK 取用者不得存取物件。

NDK 提供者必須確保 NdkCloseCompletion 函式（NDK_FN_CLOSE_COMPLETION）是針對關閉的物件呼叫的最後一個回呼。提供者必須確保所有未處理的異步要求都已完成，而且所有進行中的回呼都已傳回，而且提供者呼叫 NdkCloseCompletion 函式之前，會先防止進一步回呼。提供者呼叫 NdkCloseCompletion 函式之後，提供者不會呼叫物件的任何完成函式或通知回呼函式。

要求

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