NDK_FN_CREATE_SHARED_ENDPOINT回呼函式（ndkpi.h）

發行項
02/07/2025

NdkCreateSharedEndpoint （NDK_FN_CREATE_SHARED_ENDPOINT）函式會建立 NDK 共用端點。

語法

NDK_FN_CREATE_SHARED_ENDPOINT NdkFnCreateSharedEndpoint;

NTSTATUS NdkFnCreateSharedEndpoint(
  [in]           NDK_ADAPTER *pNdkAdapter,
                 const PSOCKADDR pAddress,
  [in]           ULONG AddressLength,
  [in]           NDK_FN_CREATE_COMPLETION CreateCompletion,
  [in, optional] PVOID RequestContext,
                 NDK_SHARED_ENDPOINT **ppNdkSharedEndpoint
)
{...}

參數

[in] pNdkAdapter

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

pAddress

用於起始傳出連線的本機位址。針對 AF_INET 或 AF_INET6 pAddress 包含本機 IP 位址和本機 ND 埠。

[in] AddressLength

pAddress 參數的本機地址數據大小，以位元組為單位。

[in] CreateCompletion

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

[in, optional] RequestContext

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

ppNdkSharedEndpoint

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

傳回值

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

傳回碼	描述
STATUS_SUCCESS	共用端點物件已成功建立，並使用 *ppNdkSharedEndpoint 參數傳回。
STATUS_PENDING	作業擱置中，稍後將會完成。提供者會呼叫 CreateCompletion 參數（NDK_FN_CREATE_COMPLETION）中指定的函式，以完成暫止的作業。
STATUS_INSUFFICIENT_RESOURCES	要求因資源不足而失敗。重要要求可能會內嵌失敗，以及使用此狀態代碼以異步方式失敗。
STATUS_SHARING_VIOLATION	要求失敗，因為指定的本機位址已在使用中。重要要求可能會內嵌失敗，以及使用此狀態代碼以異步方式失敗。
STATUS_TOO_MANY_ADDRESSES	要求失敗，因為取用者指定了本機埠號碼為零，而且網路直接提供者無法從暫時埠空間配置埠（埠 49152-65535）。
STATUS_INVALID_ADDRESS	要求失敗，因為指定的本機位址不是適配卡的有效位址。重要要求可能會內嵌失敗，以及使用此狀態代碼以異步方式失敗。
其他狀態代碼	發生錯誤。

言論

NdkCreateSharedEndpoint 函式會建立 NDK 共用端點，以作為多個目的地為不同遠端位址的傳出連線的本機位址。這類似於有多個連入連線到接聽程序物件所表示的相同本機位址。

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

要求

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