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 |
| 対象プラットフォーム | Windows |
| ヘッダー | ndkpi.h (Ndkpi.h を含む) |
| IRQL | <=DISPATCH_LEVEL |