NDK_FN_CREATE_LISTENER コールバック関数 (ndkpi.h)

[アーティクル]
02/26/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

NDK オブジェクトの作成を完了する NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) 関数へのポインター。

[in, optional] RequestContext

NDK プロバイダーが CreateCompletion パラメーターで指定された NdkCreateCompletion 関数に戻すコンテキスト値。

ppNdkListener

要求がSTATUS_PENDINGを返さずに成功した場合、作成された NDK リスナーオブジェクト (NDK_LISTENER) へのポインターがこの場所に返されます。 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を返す場合、CreateCompletion パラメーターで指定された NdkCreateCompletion (NDK_FN_CREATE_COMPLETION) 関数によって作成されたオブジェクトが返されます。

要件

要件	値
サポートされている最小のクライアント	サポートされていません。NDIS 6.30 以降でサポートされています。
サポートされている最小のサーバー	Windows Server 2012
対象プラットフォーム	Windows
ヘッダー	ndkpi.h (Ndkpi.h を含む)
IRQL	<=DISPATCH_LEVEL