NDK_FN_ACCEPT_EX Rückruffunktion (ndkpi.h)

Artikel
02/07/2025

Die NdkAcceptEx- (NDK_FN_ACCEPT_EX) akzeptiert eine eingehende Verbindungsanforderung über ein Listenerobjekt.

Syntax

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
)
{...}

Parameter

[in] pNdkConnector

Ein Zeiger auf ein NDK-Verbinderobjekt (NDK_CONNECTOR).

[in] pNdkQp

Ein Zeiger auf ein NDK-Warteschlangenpaar (QP)-Objekt (NDK_QP), das der Verbindung zugeordnet werden soll.

[in] InboundReadLimit

Die vom Verbraucher bereitgestellte maximale Anzahl eingehender in Bearbeitung ausgeführter Lesevorgänge, die für den QP zulässig sind. Wenn der zugrunde liegende Anbieter einen niedrigeren MaxInboundReadLimit Wert in der NDK_ADAPTER_INFO-Struktur aufweist, wird der vom Anbieter bereitgestellte Wert auf den Maximalwert des Anbieters begrenzt. Wenn der Peer einen niedrigeren OutboundReadLimit-wert hat, verwendet der Anbieter diesen Wert als effektiven InboundReadLimit-. Der Consumer kann die effektive InboundReadLimit- abrufen, indem die funktion NdkGetConnectionData (NDK_FN_GET_CONNECTION_DATA) aufgerufen wird.

[in] OutboundReadLimit

Die vom Verbraucher bereitgestellte maximale Anzahl ausgehender laufender Lesevorgänge, die für den QP zulässig sind. Wenn der zugrunde liegende Anbieter einen niedrigeren MaxOutboundReadLimit- Wert in der NDK_ADAPTER_INFO-Struktur aufweist, wird der vom Anbieter angegebene Wert für den Anbieter maximal begrenzt. Wenn der Peer einen niedrigeren InboundReadLimit-hat, verwendet der Anbieter diesen Wert als effektive OutboundReadLimit. Der Consumer kann das effektive OutboundReadLimit- abrufen, indem er die funktion NdkGetConnectionData (NDK_FN_GET_CONNECTION_DATA) aufruft.

[_In_reads_bytes_opt_(PrivateDataLength)] pPrivateData

Private Daten, die mit der Accept-Anforderung zurückgesendet werden.

[in] PrivateDataLength

Die Länge der privaten Daten, die im pPrivateData Parameter bereitgestellt werden.

[in, optional] DisconnectEvent

Ein Einstiegspunkt für eine optionale Disconnect-Benachrichtigungsrückruffunktion NdkDisconnectEventCallbackEx NDK_FN_DISCONNECT_EVENT_CALLBACK_EX. Der Anbieter ruft diese Rückruffunktion auf, wenn der Peer die Verbindung trennt.

[in, optional] DisconnectEventContext

Ein Kontextwert, der an den DisconnectEventContext Parameter der Rückruffunktion übergeben werden soll, die im parameter DisconnectEvent angegeben ist.

[in] RequestCompletion

Ein Zeiger auf eine Anforderungsabschlussrückrufroutine NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION).

[in, optional] RequestContext

Ein Kontextwert, der an den parameter Context der Rückruffunktion übergeben werden soll, die im RequestCompletion Parameter angegeben ist.

Rückgabewert

Die NDK_FN_ACCEPT_EX-Funktion gibt einen der folgenden NTSTATUS-Codes zurück.

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Vorgang wurde erfolgreich abgeschlossen.
STATUS_PENDING	Der Vorgang steht aus und wird später abgeschlossen. Der Treiber ruft die angegebene RequestCompletion (NDK_FN_REQUEST_COMPLETION) -Funktion auf, um den ausstehenden Vorgang abzuschließen.
STATUS_CONNECTION_ABORTED	Der Verbindungsspeer hat die ausstehende Verbindungseinrichtung abgebrochen.
STATUS_IO_TIMEOUT	Der Peer hat die Funktion CompleteConnect (NDK_FN_COMPLETE_CONNECT_EX) nicht aufgerufen, um die ausstehende Verbindungsanforderung abzuschließen.
Andere Statuscodes	Fehler.

Bemerkungen

Der NDK-Consumer ruft NdkAcceptEx- auf, um eine eingehende Verbindungsanforderung über ein Listenerobjekt zu akzeptieren.

Die NdkCreateListener- (NDK_FN_CREATE_LISTENER) erstellt ein NDK-Listenerobjekt und stellt eine NdkConnectEventCallback -Funktion (NDK_FN_CONNECT_EVENT_CALLBACK) bereit.

Die NdkConnectEventCallback--Funktion wird vom NDK-Anbieter verwendet, um den Verbraucher über jede eingehende Verbindungsanforderung zu benachrichtigen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Unterstützt in NDKPI 2.1 und höher.
mindestens unterstützte Server-	Windows Server 2022
Zielplattform-	Fenster
Header-	ndkpi.h (include Ndkpi.h)
IRQL-	<=DISPATCH_LEVEL