NDK_FN_ACCEPT回呼函式 (ndkpi.h)

發行項
02/29/2024

NdkAccept (NDK_FN_ACCEPT) 函式會透過接聽程式物件接受連入連線要求。

語法

NDK_FN_ACCEPT NdkFnAccept;

NTSTATUS NdkFnAccept(
  [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 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

選擇性中斷連線通知回呼函式 NdkDisconnectEventCallback (NDK_FN_DISCONNECT_EVENT_CALLBACK) 的進入點。當對等中斷連線時，提供者會呼叫此回呼函式。

[in, optional] DisconnectEventContext

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

[in] RequestCompletion

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

[in, optional] RequestContext

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

傳回值

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

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

備註

NDK 取用者會呼叫 NdkAccept ，以透過接聽程式物件接受連入連線要求。

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

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

規格需求

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