NDK_FN_CREATE_PD回呼函式（ndkpi.h）

發行項
02/07/2025

NdkCreatePd （NDK_FN_CREATE_PD）函式會建立 NDK 保護網域（PD）物件。

語法

NDK_FN_CREATE_PD NdkFnCreatePd;

NTSTATUS NdkFnCreatePd(
  [in]           NDK_ADAPTER *pNdkAdapter,
  [in]           NDK_FN_CREATE_COMPLETION CreateCompletion,
  [in, optional] PVOID RequestContext,
                 NDK_PD **ppNdkPd
)
{...}

參數

[in] pNdkAdapter

NDK 配接器物件的指標（NDK_ADAPTER）。

[in] CreateCompletion

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

[in, optional] RequestContext

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

ppNdkPd

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

傳回值

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

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

言論

NdkCreatePd 函式會建立 NDK 保護網域（PD）物件。如果函式傳回STATUS_SUCCESS，則會在 ppNdkPd 參數中傳回已建立的物件。如果 NdkCreatePd 傳回STATUS_PENDING，則建立的物件會由 NdkCreateCompletion （NDK_FN_CREATE_COMPLETION）函式所傳回，該函式是在 createCompletion 參數中指定的。

要求

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