共用方式為


NDK_FN_ACCEPT_EX回呼函式 (ndkpi.h)

NdkAcceptEx (NDK_FN_ACCEPT_EX) 函式會透過接聽程序物件接受連入連線要求。

語法

NDK_FN_ACCEPT_EX NdkFnAcceptEx;

NTSTATUS NdkFnAcceptEx(
  [in]                                      NDK_CONNECTOR *pNdkConnector,
  [in]                                      NDK_QP *pNdkQp,
  [in]                                      ULONG InboundReadLimit,
  [in]                                      ULONG OutboundReadLimit,
  [_In_reads_bytes_opt_(PrivateDataLength)] const PVOID pPrivateData,
  [in]                                      ULONG PrivateDataLength,
  [in, optional]                            NDK_FN_DISCONNECT_EVENT_CALLBACK_EX DisconnectEvent,
  [in, optional]                            PVOID DisconnectEventContext,
  [in]                                      NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional]                            PVOID RequestContext
)
{...}

參數

[in] pNdkConnector

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

[in] pNdkQp

NDK 佇列配對的指標, (QP ) 物件 (NDK_QP) 與連接產生關聯。

[in] InboundReadLimit

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

[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, optional] DisconnectEvent

選擇性中斷連線通知回呼函式 NdkDisconnectEventCallbackEx NDK_FN_DISCONNECT_EVENT_CALLBACK_EX的進入點。 當對等中斷連線時,提供者會呼叫此回呼函式。

[in, optional] DisconnectEventContext

要傳遞至 DisconnectEvent 參數中指定之回調函式之 DisconnectEventContext 參數的內容值。

[in] RequestCompletion

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

[in, optional] RequestContext

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

傳回值

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

傳回碼 Description
STATUS_SUCCESS 作業已成功完成。
STATUS_PENDING 作業擱置中,稍後將會完成。 驅動程式會呼叫指定的 RequestCompletion (NDK_FN_REQUEST_COMPLETION) 函式來完成暫止作業。
STATUS_CONNECTION_ABORTED 線上對等已放棄擱置的連線建立。
STATUS_IO_TIMEOUT 對等未呼叫 CompleteConnect (NDK_FN_COMPLETE_CONNECT_EX) 函式來完成擱置的連線要求。
其他狀態代碼 發生錯誤。

備註

NDK 取用者會呼叫 NdkAcceptEx ,以接受接聽程式對象的連入連線要求。

NdkCreateListener (NDK_FN_CREATE_LISTENER) 函式會建立 NDK 接聽程序物件,並提供 NdkConnectEventCallback 函式 (NDK_FN_CONNECT_EVENT_CALLBACK) 。

NDK 提供者會使用 NdkConnectEventCallback 函式來通知取用者每個連入連線要求。

規格需求

需求
最低支援的用戶端 NDKPI 2.1 和更新版本支援。
最低支援的伺服器 Windows Server 2022
目標平台 Windows
標頭 ndkpi.h (包含 Ndkpi.h)
IRQL <=DISPATCH_LEVEL

另請參閱

NDK_FN_DISCONNECT_EVENT_CALLBACK_EX

NDK_FN_COMPLETE_CONNECT_EX

NDKPI 物件存留期需求

NDK_ADAPTER_INFO

NDK_CONNECTOR

NDK_CONNECTOR_DISPATCH

NDK_FN_CONNECT_EVENT_CALLBACK

NDK_FN_CREATE_LISTENER

NDK_FN_GET_CONNECTION_DATA

NDK_FN_REJECT

NDK_FN_REQUEST_COMPLETION

NDK_QP