NDK_FN_COMPLETE_CONNECT - NtDoc

Native API online documentation, based on the System Informer (formerly Process Hacker) phnt headers 
// ndkpi.h

NDK_FN_COMPLETE_CONNECT NdkFnCompleteConnect;

NTSTATUS NdkFnCompleteConnect(
  [in]           NDK_CONNECTOR *pNdkConnector,
  [in, optional] NDK_FN_DISCONNECT_EVENT_CALLBACK DisconnectEvent,
  [in, optional] PVOID DisconnectEventContext,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

View the official Windows Driver Kit DDI reference

NtDoc

No description available.

Edit description on GitHub

Windows Driver Kit DDI reference (nc-ndkpi-ndk_fn_complete_connect)

NDK_FN_COMPLETE_CONNECT callback function

Description

The NdkCompleteConnect (NDK_FN_COMPLETE_CONNECT) function completes an asynchronous connection request.

Parameters

pNdkConnector [in]

A pointer to an NDK connector object (NDK_CONNECTOR).

DisconnectEvent [in, optional]

An optional disconnect notification callback NdkDisconnectEventCallback function(NDK_FN_DISCONNECT_EVENT_CALLBACK) that the provider calls when the peer disconnects.

DisconnectEventContext [in, optional]

A context value to pass back to the NdkDisconnectEventCallback function that is specified in the DisconnectEvent parameter.

RequestCompletion [in]

A pointer to a request completion callback NdkRequestCompletion function (NDK_FN_REQUEST_COMPLETION).

RequestContext [in, optional]

A context value that the provider passes back to the NdkRequestCompletion function that is specified in the RequestCompletion parameter.

Return value

The NDK_FN_COMPLETE_CONNECT function returns one of the following NTSTATUS codes.

Return code Description
STATUS_SUCCESS The request was completed successfully.
STATUS_PENDING The request is pending. The provider will call the NdkRequestCompletion function that is specified in the RequestCompletion parameter to complete the request asynchronously.
STATUS_CONNECTION_INVALID The request failed because the queue pair is not connecting.

Important The request can fail inline as well as asynchronously with this status code.
STATUS_CONNECTION_ABORTED The accepting peer abandoned the pending connection establishment.
STATUS_IO_TIMEOUT The request failed because the connection establishment timed out. This is not an indication of a catastrophic or permanent failure, but it ends connection establishment for this connector.

Important The request can fail inline as well as asynchronously with this status code.
Other status codes An error occurred.

Remarks

The NdkCompleteConnect function completes a connection request that was initiated by a previous call to the NdkConnect (NDK_FN_CONNECT) function. The NDK consumer calls NdkCompleteConnect after the peer accepts the connection request.

See also

NDKPI Object Lifetime Requirements

NDK_CONNECTOR

NDK_CONNECTOR_DISPATCH

NDK_FN_CONNECT

NDK_FN_DISCONNECT_EVENT_CALLBACK

NDK_FN_REQUEST_COMPLETION

View the official Windows Driver Kit DDI reference

Edit description on GitHub