NDK_FN_INVALIDATE回呼函式 (ndkpi.h)

發行項
02/26/2024

NdkInvalidate (NDK_FN_INVALIDATE) 函式使快速緩存器 NDK 記憶體區域失效， (MR) 或記憶體視窗 () 。

語法

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

記憶體區域指標 (MR) 物件 (NDK_MR) ) 或NDK_MW NDK_OBJECT_HEADER結構中指定的記憶體 () (NDK_MW) 。如果指定 MR 物件，則 MR 對象必須已向 NdkFastRegister (NDK_FN_FAST_REGISTER ) 函式註冊。 NDK 取用者絕對不能在 pNdkMrOrMw 參數中指定向 NdkRegister (NDK_FN_REGISTER) 函式註冊的 MR 物件。您可以使用 NdkDeregisterMr (NDK_FN_DEREGISTER_MR) 函式移除向 NdkRegister (NDK_FN_REGISTER) ) 函式註冊的 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) 和更新版本才支援此旗標。

傳回值

The
NdkInvalidate 函式會傳回下列其中一個NTSTATUS程式碼。

傳回碼	Description
STATUS_SUCCESS	已成功張貼要求。完成專案會在工作要求完成時排入 CQ 佇列。
STATUS_CONNECTION_INVALID	QP 未連線。
其他狀態代碼	發生錯誤。

備註

NdkInvalidate 會使 NDK 快速快取器 MR 或 URL 失效。

規格需求

需求	值
最低支援的用戶端	NDIS 6.30 和更新版本中不支援，不支援。
最低支援的伺服器	Windows Server 2012
目標平台	Windows
標頭	ndkpi.h (包含 Ndkpi.h)
IRQL	<=DISPATCH_LEVEL