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

NdkModifySrq (NDK_FN_MODIFY_SRQ) 関数は、NDK 共有受信キュー (SRQ) のサイズと通知しきい値を変更します。

構文

NDK_FN_MODIFY_SRQ NdkFnModifySrq;

NTSTATUS NdkFnModifySrq(
  [in]           NDK_SRQ *pNdkSrq,
  [in]           ULONG SrqDepth,
  [in]           ULONG NotifyThreshold,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

パラメーター

[in] pNdkSrq

NDK 共有受信キュー (SRQ) オブジェクト (NDK_SRQ) へのポインター。

[in] SrqDepth

SRQ の新しいサイズ。 新しいサイズは、NDK_ADAPTER_INFO構造体の MaxSrqDepth メンバーで指定されたサイズ以下である必要があります。 サイズが 0 の場合、深度の変更は要求されません。 つまり、既存の SRQ 深度値を保持する必要があります。

[in] NotifyThreshold

SRQ 通知コールバックをトリガーするキューに登録された受信要求の数。 この値が 0 より大きい場合、NDK プロバイダーは、キューに登録された受信要求の数が指定した値を下回ったときにトリガーする SRQ 通知をアームする必要があります。 キューに登録された受信要求の数がこの関数呼び出し時に既にしきい値を下回っている場合は、SRQ 通知を生成する必要があります。 SRQ 通知が生成されると、NDK コンシューマーがこの関数を 0 以外のしきい値で再度呼び出すまで、さらに通知が解除されます。 しきい値が 0 の場合、プロバイダーは現在の SRQ 通知しきい値とアーミング状態を保持する必要があります。

[in] RequestCompletion

要求完了コールバック ルーチン NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION) へのポインター。

[in, optional] RequestContext

RequestCompletion パラメーターで指定されたコールバック関数の Context パラメーターに渡すコンテキスト値。

戻り値

NdkModifySrq 関数は、次の NTSTATUS コードのいずれかを返します。

解説

NdkModifySrq は、NDK 共有受信キュー (SRQ) オブジェクト (NDK_SRQ) のサイズと通知のしきい値を変更します。

要件

こちらもご覧ください

NDKPI オブジェクト有効期間要件

NDK_ADAPTER_INFO

NDK_FN_REQUEST_COMPLETION

NDK_SRQ