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

  • [アーティクル]

NdkCqNotificationCallback (NDK_FN_CQ_NOTIFICATION_CALLBACK) 関数は、完了キュー (CQ) イベントについてコンシューマーに通知するために、NDK プロバイダーによって呼び出されます。

構文

NDK_FN_CQ_NOTIFICATION_CALLBACK NdkFnCqNotificationCallback;

void NdkFnCqNotificationCallback(
  [in, optional] PVOID CqNotificationContext,
  [in]           NTSTATUS CqStatus
)
{...}

パラメーター

[in, optional] CqNotificationContext

完了キュー (CQ) オブジェクトの作成時に NdkCreateCq (NDK_FN_CREATE_CQ) 関数の CqNotificationContext パラメーターで指定されたコンテキスト領域。

[in] CqStatus

CQ エラーの状態を示します。 次の状態コードが定義されています。

期間 説明
STATUS_SUCCESS CQ が正常に動作中であることを示します。
STATUS_BUFFER_OVERFLOW CQ が保持できる最大の完了数よりも多くの完了が CQ でキューに登録され、CQ が使用できないことを示します。 関連付けられているすべてのキュー ペア (QP) も使用できません。 今後の完了は報告されません。 通常、STATUS_BUFFER_OVERFLOW エラーはプログラミング エラーを示します。
STATUS_INTERNAL_ERROR CQ で致命的なエラーが発生し、CQ が使用不能であることを示します。 関連付けられているすべてのキュー ペア (QP) も使用できません。 今後の完了は報告されません。 通常、STATUS_INTERNAL_ERROR エラーはハードウェア エラーを示します。

戻り値

なし

解説

NDK プロバイダーは NdkCqNotificationCallback を 呼び出して、完了キュー (CQ) イベントについてコンシューマーに通知します。

NDK コンシューマーは、完了キュー (CQ) オブジェクトが作成されたときに、NdkCreateCq (NDK_FN_CREATE_CQ) 関数の CqNotificationContext パラメーターに NdkCqNotificationCallback 関数を指定しました。

要件

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

こちらもご覧ください

NDKPI 完了処理要件

NDK_FN_CREATE_CQ