NDK_FN_INVALIDATE コールバック関数 (ndkpi.h)
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 プロバイダーに対して、処理の要求をハードウェアに示す遅延が発生する可能性があることを示します。 このフラグの詳細については、「NDKPI 遅延処理スキームを参照してください。
注 このフラグは、NDKPI 1.2 (Windows Server 2012 R2) 以降でのみサポートされます。 |
戻り値
ザ
NdkInvalidate 関数、次のいずれかの NTSTATUS コードが返されます。
| リターン コード | 形容 |
|---|---|
|
要求が正常に投稿されました。 作業要求が完了すると、完了エントリが CQ にキューに入れられます。 |
|
QP が接続されていません。 |
|
エラーが発生しました。 |
備考
NdkInvalidate は、NDK 高速レジスタ MR または MW を無効にします。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | サポートされていません。NDIS 6.30 以降でサポートされています。 |
| サポートされる最小サーバー | Windows Server 2012 |
| ターゲット プラットフォーム の | ウィンドウズ |
| ヘッダー | ndkpi.h (Ndkpi.h を含む) |
| IRQL | <=DISPATCH_LEVEL |