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

[アーティクル]
08/07/2023

NdkInitializeFastRegisterMr (NDK_FN_INITIALIZE_FAST_REGISTER_MR) 関数は、高速登録のために NDK メモリ領域 (MR) を初期化します。

構文

NDK_FN_INITIALIZE_FAST_REGISTER_MR NdkFnInitializeFastRegisterMr;

NTSTATUS NdkFnInitializeFastRegisterMr(
  [in]           NDK_MR *pNdkMr,
  [in]           ULONG AdapterPageCount,
  [in]           BOOLEAN RemoteAccess,
  [in]           NDK_FN_REQUEST_COMPLETION RequestCompletion,
  [in, optional] PVOID RequestContext
)
{...}

パラメーター

[in] pNdkMr

NDK メモリ領域 (MR) オブジェクト (NDK_MR) へのポインター。

[in] AdapterPageCount

この MR でサポートするアダプターページの最大数。同じかそれより少な数のアダプターページを含む高速登録作業要求をサポートできます。

[in] RemoteAccess

MR をリモートアクセス用に初期化する必要があるかどうかを示す BOOLEAN 値。コンシューマーが NdkFastRegister (NDK_FN_FAST_REGISTER) 関数を使用してリモートアクセスを要求する場合、NDK コンシューマーは RemoteAccess を TRUE に設定する必要があります。

[in] RequestCompletion

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

[in, optional] RequestContext

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

戻り値

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

リターンコード	説明
STATUS_SUCCESS	初期化が正常に完了しました。
STATUS_PENDING	操作は保留中であり、後で完了します。ドライバーは、指定した RequestCompletion (NDK_FN_REQUEST_COMPLETION) 関数を呼び出して、保留中の操作を完了します。
STATUS_IMPLEMENTATION_LIMIT	アダプターが要求された AdapterPageCount をサポートしていないため、要求は失敗しました。
その他の状態コード	エラーが発生しました。

解説

NdkInitializeFastRegisterMr は 、高速登録のために MR を初期化します。 NDK_MR オブジェクトは、NdkCreateMr (NDK_FN_CREATE_MR) 関数の FastRegister パラメーターを TRUE に設定して作成する必要があります。

NdkInitializeFastRegisterMr に対して複数の呼び出しを並列または 1 つずつ行うことができます。

NdkInitializeFastRegisterMr が戻った後、高速登録作業要求をキューペア (QP) にポストできます。

要件

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