NDK_FN_INITIALIZE_FAST_REGISTER_MR回呼函式 (ndkpi.h)

發行項
02/26/2024

NdkInitializeFastRegisterMr (NDK_FN_INITIALIZE_FAST_REGISTER_MR) 函式會初始化 NDK 記憶體區域 (MR) 以進行快速註冊。

語法

NDK_FN_INITIALIZE_FAST_REGISTER_MR NdkFnInitializeFastRegisterMr;

NTSTATUS NdkFnInitializeFastRegisterMr(
  [in]           NDK_MR *pNdkMr,
  [in]           ULONG AdapterPageCount,
  [in]           BOOLEAN RemoteAccess,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

參數

[in] pNdkMr

NDK 記憶體區域的指標， (MR) 物件 (NDK_MR) 。

[in] AdapterPageCount

此 MR 中支援的最大配接器頁面數目，因此可以支援快速註冊等於或較低數目的配接器頁面工作要求。

[in] RemoteAccess

BOOLEAN 值，指出是否必須初始化 MR 以進行遠端訪問。如果取用者向 NdkFastRegister 要求遠端訪問，則 NDK 取用者必須將 RemoteAccess 設定為 TRUE (NDK_FN_FAST_REGISTER) 函式。

[in] RequestCompletion

要求完成回呼例程的指標 NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION) 。

[in, optional] RequestContext

要傳遞至 RequestCompletion 參數中所指定回呼函式之 Context 參數的內容值。

傳回值

The
NdkInitializeFastRegisterMr 函式會傳回下列其中一個 NTSTATUS 代碼。

傳回碼	Description
STATUS_SUCCESS	初始化已順利完成。
STATUS_PENDING	作業擱置中，稍後將會完成。驅動程式會呼叫指定的 RequestCompletion (NDK_FN_REQUEST_COMPLETION) 函式來完成擱置作業。
STATUS_IMPLEMENTATION_LIMIT	要求失敗，因為配接器不支援要求的 AdapterPageCount。
其他狀態代碼	發生錯誤。

備註

NdkInitializeFastRegisterMr 會初始化 MR 以進行快速註冊。 NDK_MR對象必須使用 NdkCreateMr (NDK_FN_CREATE_MR) 函式的 FastRegister 參數建立。

您可以平行或逐一呼叫 NdkInitializeFastRegisterMr。

在 NdkInitializeFastRegisterMr 傳回之後，可以將快速註冊工作要求張貼至佇列配對 (QP) 。

規格需求

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