共用方式為

NDK_FN_CREATE_MR回呼函式 （ndkpi.h）

  • 發行項

NdkCreateMr （NDK_FN_CREATE_MR） 函式會建立 NDK 記憶體區域 （MR） 物件。

語法

NDK_FN_CREATE_MR NdkFnCreateMr;

NTSTATUS NdkFnCreateMr(
  [in]           NDK_PD *pNdkPd,
  [in]           BOOLEAN FastRegister,
  [in]           NDK_FN_CREATE_COMPLETION CreateCompletion,
  [in, optional] PVOID RequestContext,
                 NDK_MR **ppNdkMr
)
{...}

參數

[in] pNdkPd

NDK 保護網域 （PD） 物件的指標（NDK_PD）。

[in] FastRegister

如果為TRUE，則 MR 僅適用於快速註冊。 否則，MR 僅適用於一般緩存器。

[in] CreateCompletion

NdkCreateCompletion （NDK_FN_CREATE_COMPLETION） 函式的指標，可完成建立 NDK 物件。

[in, optional] RequestContext

NDK 提供者傳回 NdkCreateCompletion 函式的內容值，該函式是在 createCompletion 參數 指定。

ppNdkMr

如果要求成功而不傳回 STATUS_PENDING，則會在此位置傳回所建立 MR 物件的指標 （NDK_MR）。 如果 NdkCreateMr 傳回 STATUS_PENDING，則會忽略此參數，並使用 createCompletion 參數中指定的回呼傳回所建立的物件。

傳回值

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

傳回碼 描述
STATUS_SUCCESS
 MR 物件已成功建立，並以 *ppNdkMr 參數 傳回。
STATUS_PENDING
 作業擱置中，稍後將會完成。 提供者會呼叫 createCompletion 參數 中指定的函式NDK_FN_CREATE_COMPLETION，以完成暫止的作業。
STATUS_INSUFFICIENT_RESOURCES
 要求因資源不足而失敗。
重要 要求可能會內嵌失敗，以及使用此狀態代碼以異步方式失敗。
 
其他狀態代碼
 發生錯誤。

言論

NdkCreateMr 函式會建立 NDK 記憶體區域 （MR） 物件，可用於記憶體註冊和快速註冊要求。 如果函式傳回 STATUS_SUCCESS，則會在 ppNdkMr 參數中傳回已建立的物件。 如果 NdkCreateMr 傳回 STATUS_PENDING，則建立的物件是由 NdkCreateCompletion （NDK_FN_CREATE_COMPLETION） 函式所傳回，而 CreateCompletion 參數中指定。

要求

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

另請參閱

NDKPI 物件存留期需求

NDK_FN_CREATE_COMPLETION

NDK_MR

NDK_PD