NDK_FN_CONNECT回呼函式 (ndkpi.h)

發行項
02/26/2024

NdkConnect (NDK_FN_CONNECT) 函式會起始 NDK 連線要求。

語法

NDK_FN_CONNECT NdkFnConnect;

NTSTATUS NdkFnConnect(
  [in]                                      NDK_CONNECTOR *pNdkConnector,
  [in]                                      NDK_QP *pNdkQp,
                                            const PSOCKADDR pSrcAddress,
  [in]                                      ULONG SrcAddressLength,
  [in]                                      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) 與連接產生關聯。

pSrcAddress

來源位址。對於 AF_INET 或 AF_INET6 pSrcAddress 是來源 IP 位址和來源 ND 埠。

[in] SrcAddressLength

pSrcAddress 參數的來源地址數據大小，以位元組為單位。

[in] 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 參數的內容值。

傳回值

NdkConnect 函式會傳回下列其中一個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_SHARING_VIOLATION	要求失敗，因為指定的本機位址已在使用中。重要要求可以透過此狀態代碼以異步方式內嵌和失敗。
STATUS_INVALID_ADDRESS	要求失敗，因為指定的本機位址不是適配卡的有效位址。重要要求可以透過此狀態代碼以異步方式內嵌和失敗。
STATUS_TOO_MANY_ADDRESSES	要求失敗，因為取用者指定了零個本機埠號碼，而網路直接提供者無法從暫時埠空間配置埠， (埠 49152-65535) 。重要要求可以透過此狀態代碼以異步方式內嵌和失敗。
STATUS_ADDRESS_ALREADY_EXISTS	要求失敗，因為本機位址、本機埠、遠端位址和遠端埠的組合已存在。重要要求可以透過此狀態代碼以異步方式內嵌和失敗。
其他狀態代碼	發生錯誤。

備註

NdkConnect 會起始從本機位址到遠端位址的連線要求。

規格需求

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