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

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

NdkInvalidate (NDK_FN_INVALIDATE) 関数は、高速レジスタ NDK メモリ領域 (MR) またはメモリウィンドウ (MW) を無効にします。

構文

NDK_FN_INVALIDATE NdkFnInvalidate;

NTSTATUS NdkFnInvalidate(
  [in]           NDK_QP *pNdkQp,
  [in, optional] PVOID RequestContext,
  [in]           NDK_OBJECT_HEADER *pNdkMrOrMw,
  [in]           ULONG Flags
)
{...}

パラメーター

[in] pNdkQp

NDK キューペア (QP) オブジェクト (NDK_QP) へのポインター。

[in, optional] RequestContext

この要求のNDK_RESULT構造体の RequestContext メンバーで返されるコンテキスト値。

[in] pNdkMrOrMw

NDK_OBJECT_HEADER構造体で指定されたメモリ領域 (MR) オブジェクト (NDK_MR) またはメモリ (MW) オブジェクト (NDK_MW) へのポインター。 MR オブジェクトを指定する場合、MR オブジェクトは NdkFastRegister (NDK_FN_FAST_REGISTER) 関数に登録されている必要があります。 NDK コンシューマーは、pNdkMrOrMw パラメーターで NdkRegister (NDK_FN_REGISTER) 関数に登録された MR オブジェクトを指定しないでください。 NdkRegister (NDK_FN_REGISTER)) 関数に登録されている MR オブジェクトへのアクセスは、NdkDeregisterMr (NDK_FN_DEREGISTER_MR) 関数を使用して削除できます。

[in] Flags

許可される操作を指定するフラグのビットごとの OR。次のフラグがサポートされています。

値	意味
NDK_OP_FLAG_SILENT_SUCCESS 0x00000001	この要求が正常に完了しても、送信完了キューに完了イベントが生成されないことを示します。ただし、失敗した要求では、完了キューにイベントが生成されます。
NDK_OP_FLAG_READ_FENCE 0x00000002	ハードウェアがこの要求の処理を開始する前に、以前のすべての読み取り要求を完了する必要があることを示します。
NDK_OP_FLAG_DEFER 0x00000200	NDK プロバイダーに対して、処理のためにハードウェアへの要求を示す遅延が発生する可能性があることを示します。このフラグの詳細については、「 NDKPI 遅延処理スキーム」を参照してください。メモこのフラグは、NDKPI 1.2 (Windows Server 2012 R2) 以降でのみサポートされます。

戻り値

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

リターンコード	説明
STATUS_SUCCESS	要求が正常に投稿されました。作業要求が完了すると、完了エントリが CQ にキューに入れられます。
STATUS_CONNECTION_INVALID	QP が接続されていません。
その他の状態コード	エラーが発生しました。

解説

NdkInvalidate は、NDK 高速レジスタ MR または MW を無効にします。

要件

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