NDK_FN_CREATE_LISTENER回呼函式 (ndkpi.h)

發行項
02/29/2024

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 接聽程式物件的指標 ( NDK_LISTENER) 。如果 NdkCreateListener 傳回STATUS_PENDING則會忽略此參數，而且會使用 CreateCompletion 參數中指定的回呼傳回已建立的物件。

傳回值

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

傳回碼	Description
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