NDK_FN_CONNECT_WITH_SHARED_ENDPOINT回呼函式 (ndkpi.h)

發行項
02/26/2024

NdkConnectWithSharedEndpoint (NDK_FN_CONNECT_WITH_SHARED_ENDPOINT) 函式會起始從共用本機地址到遠端位址的 NDK 連線要求。

語法

NDK_FN_CONNECT_WITH_SHARED_ENDPOINT NdkFnConnectWithSharedEndpoint;

NTSTATUS NdkFnConnectWithSharedEndpoint(
  [in]                                      NDK_CONNECTOR *pNdkConnector,
  [in]                                      NDK_QP *pNdkQp,
  [in]                                      NDK_SHARED_ENDPOINT *pNdkSharedEndpoint,
                                            const PSOCKADDR pDestAddress,
  [in]                                      ULONG DestAddressLength,
  [in]                                      ULONG InboundReadLimit,
  [in]                                      ULONG OutboundReadLimit,
  [_In_reads_bytes_opt_(PrivateDataLength)] const PVOID pPrivateData,
  [in]                                      ULONG PrivateDataLength,
  [in]                                      NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional]                            PVOID RequestContext
)
{...}

參數

[in] pNdkConnector

NDK 連接器物件的指標 (NDK_CONNECTOR) 。

[in] pNdkQp

NDK 佇列組的指標， (QP) 物件 (NDK_QP) 與連接相關聯。

[in] pNdkSharedEndpoint

判斷連線本機位址的NDK共用端點對象指標 (NDK_SHARED_ENDPOINT) 。

pDestAddress

目的地位址。對於 AF_INET 或 AF_INET6 pDestAddress 是目的地 IP 位址和目的地 ND 埠。

[in] DestAddressLength

pDestAddress 參數目的地地址數據的大小，以位元組為單位。

[in] InboundReadLimit

取用者提供的傳入進行中讀取作業數目上限，以在QP上允許。如果基礎提供者在 NDK_ADAPTER_INFO 結構中有較低的 MaxInboundReadLimit 值，則提供者會將取用者提供的值上限為提供者最大值。如果對等具有較低的 OutboundReadLimit 值，則提供者會使用該值作為有效的 InboundReadLimit。取用者可以藉由呼叫 NdkGetConnectionData 函式來擷取有效的 InboundReadLimit (NDK_FN_GET_CONNECTION_DATA) 。

[in] OutboundReadLimit

取用者提供在 QP 上允許的傳出進行中讀取作業數目上限。如果基礎提供者在 NDK_ADAPTER_INFO 結構中有較低的 MaxOutboundReadLimit 值，則提供者會將取用者提供的值上限為提供者最大值。如果對等具有較低的 InboundReadLimit，則提供者會使用該值作為有效的 OutboundReadLimit。取用者可以藉由呼叫 NdkGetConnectionData 函式 (NDK_FN_GET_CONNECTION_DATA) 來擷取有效的 OutboundReadLimit。

[_In_reads_bytes_opt_(PrivateDataLength)] pPrivateData

與連線要求一起傳送的私人數據指標。

[in] PrivateDataLength

pPrivateData 參數中提供的私用數據長度，以位元組為單位。

[in] RequestCompletion

要求完成回呼例程的指標 NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION) 。

[in, optional] RequestContext

要傳遞至 RequestCompletion 參數中所指定回呼函式之 Context 參數的內容值。

傳回值

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

傳回碼	Description
STATUS_SUCCESS	線上要求已成功完成。
STATUS_PENDING	作業擱置中，稍後將會完成。驅動程式會呼叫指定的 RequestCompletion (NDK_FN_REQUEST_COMPLETION) 函式來完成擱置作業。
STATUS_INSUFFICIENT_RESOURCES	要求失敗，因為資源不足。重要要求可以透過此狀態代碼以異步方式內嵌和失敗。
STATUS_NETWORK_UNREACHABLE	要求失敗，因為無法連線到遠端網路。可能會重試連線嘗試。重要要求可以透過此狀態代碼以異步方式內嵌和失敗。
STATUS_HOST_UNREACHABLE	要求失敗，因為無法連線到遠端系統。可能會重試連線嘗試。重要要求可以透過此狀態代碼以異步方式內嵌和失敗。
STATUS_CONNECTION_REFUSED	要求失敗，因為遠端系統拒絕連線要求。這可能是因為缺少接聽程式、待辦專案限制，或對等主動拒絕連線要求。可能會重試連線嘗試。重要要求可以透過此狀態代碼以異步方式內嵌和失敗。
STATUS_IO_TIMEOUT	要求失敗，因為連線要求逾時。可能會重試連線嘗試。網路直接提供者會選取逾時值，以符合其各自的網路特性。重要要求可以透過此狀態代碼以異步方式內嵌和失敗。
STATUS_ADDRESS_ALREADY_EXISTS	要求失敗，因為本機位址、本機埠、遠端位址和遠端埠的組合已存在。重要要求可以透過此狀態代碼以異步方式內嵌和失敗。
其他狀態代碼	發生錯誤。

備註

NdkConnectWithSharedEndpoint 會起始從共用本機位址到特定遠端位址的連線要求。 NdkConnectWithSharedEndpoint 可讓 NDK 取用者在連線的目的地地址不同時，使用相同的本機位址 (，例如 10.1.1.1：9999) 。

規格需求

需求	值
最低支援的用戶端	不支援，NDIS 6.30 和更新版本中支援。
最低支援的伺服器	Windows Server 2012
目標平台	Windows
標頭	ndkpi.h (包括 Ndkpi.h)
IRQL	<=DISPATCH_LEVEL