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

  • [アーティクル]

NdkResizeCq (NDK_FN_RESIZE_CQ) 関数は、NDK 完了キュー (CQ) のサイズを変更します。

構文

NDK_FN_RESIZE_CQ NdkFnResizeCq;

NTSTATUS NdkFnResizeCq(
  [in]           NDK_CQ *pNdkCq,
  [in]           ULONG CqDepth,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

パラメーター

[in] pNdkCq

NDK 完了キュー (CQ) オブジェクト (NDK_CQ) へのポインター。

[in] CqDepth

CQ が保持できる新しい完了エントリ数。 CQ サイズは、NDK_ADAPTER_INFO構造体の MaxCqDepth メンバーで指定された値以下である必要があります。

[in] RequestCompletion

NdkRequestCompletion (NDK_FN_REQUEST_COMPLETION) 関数へのポインター。

[in, optional] RequestContext

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

戻り値

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

リターン コード 説明
STATUS_SUCCESS
 CQ のサイズが正常に変更されました。
STATUS_PENDING
 操作は保留中であり、後で完了します。 ドライバーは、指定した RequestCompletion (NDK_FN_REQUEST_COMPLETION) 関数を呼び出して、保留中の操作を完了します。
STATUS_INVALID_PARAMETER
 CqDepth パラメーターで指定された CQ サイズが、NDK_ADAPTER_INFO構造体の MaxCqDepth メンバーの値より大きいため、要求は失敗しました。
STATUS_INSUFFICIENT_RESOURCES
 リソースが不足しているため、要求は失敗しました。
大事な 要求はインラインで失敗し、この状態コードを使用して非同期的に失敗する可能性があります。
 
その他の状態コード
 エラーが発生しました。

解説

NdkResizeCq は、 CQ が保持できる完了エントリの数を変更します。

要件

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

こちらもご覧ください

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

NDK_ADAPTER_INFO

NDK_CQ

NDK_CQ_DISPATCH

NDK_FN_REQUEST_COMPLETION