NDK_FN_CREATE_LISTENER回调函数 (ndkpi.h)

项目
08/07/2023

NdkCreateListener (NDK_FN_CREATE_LISTENER) 函数创建 NDK 侦听器对象。

语法

NDK_FN_CREATE_LISTENER NdkFnCreateListener;

NTSTATUS NdkFnCreateListener(
  [in]           NDK_ADAPTER *pNdkAdapter,
  [in]           NDK_FN_CONNECT_EVENT_CALLBACK ConnectEvent,
  [in, optional] PVOID ConnectEventContext,
  [in]           NDK_FN_CREATE_COMPLETION CreateCompletion,
  [in, optional] PVOID RequestContext,
                 NDK_LISTENER **ppNdkListener
)
{...}

参数

[in] pNdkAdapter

指向 NDK 适配器对象的指针 (NDK_ADAPTER) 。

[in] ConnectEvent

指向 NdkConnectEventCallback 函数的指针 (NDK_FN_CONNECT_EVENT_CALLBACK) ，提供程序使用该) 来通知每个传入连接请求的使用者。

[in, optional] ConnectEventContext

NDK 提供程序传递回 ConnectEvent 参数中指定的 NdkConnectEventCallback 函数的上下文值。

[in] CreateCompletion

指向 NdkCreateCompletion (NDK_FN_CREATE_COMPLETION 完成 NDK 对象的创建) 函数的指针。

[in, optional] RequestContext

NDK 提供程序传递回 CreateCompletion 参数中指定的 NdkCreateCompletion 函数的上下文值。

ppNdkListener

如果请求成功但不返回STATUS_PENDING，则此位置返回 (NDK_LISTENER) 创建的 NDK 侦听器对象的指针。如果 NdkCreateListener 返回STATUS_PENDING则忽略此参数，并使用 CreateCompletion 参数中指定的回调返回创建的对象。

返回值

NdkCreateListener 函数返回以下 NTSTATUS 代码之一。

返回代码	说明
STATUS_SUCCESS	侦听器对象已成功创建，并使用 *ppNdkListener 参数返回。
STATUS_PENDING	操作处于挂起状态，稍后将完成。提供程序将调用 CreateCompletion 参数中指定的函数 (NDK_FN_CREATE_COMPLETION) 来完成挂起的操作。
STATUS_INSUFFICIENT_RESOURCES	由于资源不足，请求失败。重要请求可能会内联失败，也可能会以异步方式失败，并显示此状态代码。
其他状态代码	出现了错误。

注解

NdkCreateListener 函数创建 NDK 侦听器对象。如果函数返回STATUS_SUCCESS，则会在 ppNdkListener 参数中返回创建的对象。如果 NdkCreateListener 返回STATUS_PENDING，则创建的对象由 NdkCreateCompletion (NDK_FN_CREATE_COMPLETIONcreateCompletion 参数中指定的) 函数返回。

要求

要求	值
最低受支持的客户端	不支持，在 NDIS 6.30 及更高版本中受支持。
最低受支持的服务器	Windows Server 2012
目标平台	Windows
标头	ndkpi.h (包括 Ndkpi.h)
IRQL	<=DISPATCH_LEVEL