NDK_FN_CLOSE_OBJECT回呼函式 (ndkpi.h)

發行項
02/26/2024

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

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

傳回值

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

傳回碼	Description
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
目標平台	Windows
標頭	ndkpi.h (包含 Ndkpi.h)
IRQL	<=DISPATCH_LEVEL