NDK_FN_CREATE_CONNECTOR回呼函式（ndkpi.h）

發行項
02/07/2025

NdkCreateConnector （NDK_FN_CREATE_CONNECTOR）函式會建立 NDK 連接器物件。

語法

NDK_FN_CREATE_CONNECTOR NdkFnCreateConnector;

NTSTATUS NdkFnCreateConnector(
  [in]           NDK_ADAPTER *pNdkAdapter,
  [in]           NDK_FN_CREATE_COMPLETION CreateCompletion,
  [in, optional] PVOID RequestContext,
                 NDK_CONNECTOR **ppNdkConnector
)
{...}

參數

[in] pNdkAdapter

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

[in] CreateCompletion

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

[in, optional] RequestContext

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

ppNdkConnector

如果要求成功而不傳回STATUS_PENDING，則會在此位置傳回 NDK 連接器物件的指標（NDK_CONNECTOR）。如果 NdkCreateConnector 傳回STATUS_PENDING會忽略此參數，而且會使用 createCompletion 參數中指定的回呼傳回所建立物件。

傳回值

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

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

言論

NdkCreateConnector 函式會建立 NDK 連接器物件。如果函式傳回STATUS_SUCCESS，則會在 ppNdkConnector 參數中傳回已建立的物件。如果 NdkCreateConnector 傳回STATUS_PENDING，則建立的物件會由 NdkCreateCompletion （NDK_FN_CREATE_COMPLETION）函式傳回，該函式是在 createCompletion 參數中指定的。

要求

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