NDK_FN_CREATE_COMPLETION回呼函式 (ndkpi.h)

發行項
02/29/2024

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 complete 函式傳回，而且提供者不得存取 create request 函式的對象輸出參數。

規格需求

需求	值
最低支援的用戶端	NDIS 6.30 和更新版本中不支援，不支援。
最低支援的伺服器	Windows Server 2012
目標平台	Windows
標頭	ndkpi.h (包含 Ndkpi.h)
IRQL	<=DISPATCH_LEVEL