NDK_FN_WRITE回呼函式 (ndkpi.h)

  • 發行項

NdkWrite (NDK_FN_WRITE) 函式會在 QP) (NDK 佇列配對上張貼寫入要求。

語法

NDK_FN_WRITE NdkFnWrite;

NTSTATUS NdkFnWrite(
  [in]           NDK_QP *pNdkQp,
  [in, optional] PVOID RequestContext,
                 const NDK_SGE *pSgl,
  [in]           ULONG nSge,
  [in]           UINT64 RemoteAddress,
  [in]           UINT32 RemoteToken,
  [in]           ULONG Flags
)
{...}

參數

[in] pNdkQp

NDK 佇列配對的指標， (QP) 物件 (NDK_QP) 。

[in, optional] RequestContext

要在此要求之 NDK_RESULT 結構的 RequestContext 成員中傳回的內容值。

pSgl

SGE 結構的陣列 (NDK_SGE) ，代表保存要寫入數據的緩衝區。

[in] nSge

pSgl 參數中所指定數位中的 SGE 結構數目。

[in] RemoteAddress

要寫入的遠端位址，以本機主機的位元組順序提供。 NDK 取用者可能已將位移新增至遠端提供的值。

[in] RemoteToken

遠端提供的記憶體令牌，這是來自 NDK 取用者的不透明位元組陣列。

[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) 和更新版本才支援此旗標。

傳回值

NdkWrite 函式會傳回下列其中一個NTSTATUS代碼。

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

備註

NdkWrite 會在佇列配對上張貼寫入要求， (QP) 。

規格需求

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

另請參閱

NDKPI 延遲處理配置

NDKPI 工作要求張貼需求

NDK_QP

NDK_RESULT

NDK_SGE