NDK_FN_COMPLETE_CONNECT_EXコールバック関数 (ndkpi.h)
NdkCompleteConnectEx (NDK_FN_COMPLETE_CONNECT_EX) 関数は、非同期接続要求を完了します。
構文
NDK_FN_COMPLETE_CONNECT_EX NdkFnCompleteConnectEx;
NTSTATUS NdkFnCompleteConnectEx(
[in] NDK_CONNECTOR *pNdkConnector,
[in, optional] NDK_FN_DISCONNECT_EVENT_CALLBACK_EX DisconnectEvent,
[in, optional] PVOID DisconnectEventContext,
[in] NDK_FN_REQUEST_COMPLETION RequestCompletion,
[in, optional] PVOID RequestContext
)
{...}
パラメーター
[in] pNdkConnector
NDK コネクタ オブジェクト (NDK_CONNECTOR) へのポインター。
[in, optional] DisconnectEvent
省略可能な切断通知コールバック関数 NdkDisconnectEventCallbackEx 関数 NDK_FN_DISCONNECT_EVENT_CALLBACK_EXのエントリ ポイント。 プロバイダーは、ピアが切断されたときにこのコールバック関数を呼び出します。
[in, optional] DisconnectEventContext
DisconnectEvent パラメーターで指定された NdkDisconnectEventCallback 関数に戻すコンテキスト値。
[in] RequestCompletion
NdkRequestCompletion 関数 (NDK_FN_REQUEST_COMPLETION) 要求完了コールバックへのポインター。
[in, optional] RequestContext
プロバイダーが NdkRequestCompletion 関数に戻すコンテキスト値。 この値は、RequestCompletion パラメーターで指定します。
戻り値
NDK_FN_COMPLETE_CONNECT 関数は、次のいずれかの NTSTATUS コードを返します。
| リターン コード | 形容 |
|---|---|
| STATUS_SUCCESS | 要求が正常に完了しました。 |
| STATUS_PENDING | 要求が保留中です。 プロバイダーは、RequestCompletion パラメーターで指定された NdkRequestCompletion 関数を呼び出して、要求を非同期的に完了します。 |
| STATUS_CONNECTION_INVALID | キュー ペアが接続していないため、要求は失敗しました。 重要な: 要求は、この状態コードを使用してインラインだけでなく非同期的にも失敗する可能性があります。 |
| STATUS_CONNECTION_ABORTED | 受け入れ側ピアは、保留中の接続確立を破棄しました。 |
| STATUS_IO_TIMEOUT | 接続の確立がタイムアウトしたため、要求は失敗しました。これは致命的または永続的な障害を示すものではありませんが、このコネクタの接続確立は終了します。 重要な: 要求は、この状態コードを使用してインラインだけでなく非同期的にも失敗する可能性があります。 |
| その他の状態コードの | エラーが発生しました。 |
備考
NdkCompleteConnectEx 関数は、NdkConnect (NDK_FN_CONNECT) 関数への以前の呼び出しによって開始された接続要求を完了します。 ピアが接続要求 受け入れた後、NDK コンシューマーは NdkCompleteConnectEx を呼び出します。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | NDKPI 2.1 以降でサポートされています。 |
| サポートされる最小サーバー | Windows Server 2022 |
| ターゲット プラットフォーム の | ウィンドウズ |
| ヘッダー | ndkpi.h (Ndkpi.h を含む) |
| IRQL | <=DISPATCH_LEVEL |