共用方式為

NDK_FN_CREATE_SHARED_ENDPOINT回呼函式 (ndkpi.h)

  • 發行項

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

完成建立 NDK 物件的 NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) 函式的指標。

[in, optional] RequestContext

NDK 提供者傳回至 CreateCompletion 參數中指定的 NdkCreateCompletion 函式的內容值。

ppNdkSharedEndpoint

如果要求成功而不傳回STATUS_PENDING，則會傳回所建立共用端點物件的 指標 (NDK_SHARED_ENDPOINT) 。 如果要求傳回STATUS_PENDING，則會忽略此參數，並使用 CreateCompletion 參數中指定的回呼傳回已建立的物件。

傳回值

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

傳回碼 Description
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
目標平台 Windows
標頭 ndkpi.h (包括 Ndkpi.h)
IRQL <=DISPATCH_LEVEL

另請參閱

NDKPI 物件存留期需求

NDK_ADAPTER

NDK_ADAPTER_DISPATCH

NDK_FN_CREATE_COMPLETION

NDK_SHARED_ENDPOINT