次の方法で共有

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
ターゲット プラットフォーム の ウィンドウズ
ヘッダー ndkpi.h (Ndkpi.h を含む)
IRQL <=DISPATCH_LEVEL

関連項目

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

NDK_ADAPTER_INFO

NDK_FN_REQUEST_COMPLETION

NDK_SRQ