次の方法で共有

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 コードのいずれかを返します。

リターン コード 説明
STATUS_SUCCESS
 要求が正常に完了しました。
STATUS_PENDING
 操作は保留中であり、後で完了します。 ドライバーは、保留中の操作を完了するために、指定した RequestCompletion (NDK_FN_REQUEST_COMPLETION) 関数を呼び出します。
STATUS_INVALID_PARAMETER
 SrqDepth パラメーターの値が、NDK_ADAPTER_INFO構造体で指定されている制限内にないため、要求は失敗しました。
その他の状態コード
 エラーが発生しました。

解説

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

要件

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

こちらもご覧ください

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

NDK_ADAPTER_INFO

NDK_FN_REQUEST_COMPLETION

NDK_SRQ