NDK_SGE 結構 (ndkpi.h)

發行項
02/26/2024

NDK_SGE 結構會指定 NDK 工作要求的本機緩衝區。

語法

typedef struct _NDK_SGE {
  union {
    PVOID               VirtualAddress;
    NDK_LOGICAL_ADDRESS LogicalAddress;
  };
  ULONG  Length;
  UINT32 MemoryRegionToken;
} NDK_SGE;

成員

VirtualAddress

虛擬位址。

LogicalAddress

邏輯位址。

Length

緩衝區的長度，以位元組為單位。

MemoryRegionToken

記憶體區域令牌。當 MemoryRegionToken 設定為 NdkGetPrivilegedMemoryRegionToken (NDK_FN_GET_PRIVILEGED_MEMORY_REGION_TOKEN) 所傳回的令牌時， NDK_SGE 必須包含 LogicalAddress。當 MemoryRegionToken 不等於 NdkGetPrivilegedMemoryRegionToken 所傳回的令牌時， NDK_SGE 結構必須包含 VirtualAddress。當 NDK_SGE 結構用於具有 NDK_OP_FLAG_INLINE 旗標的工作要求時， MemoryRegionToken 可能無效。如需 MemoryRegionToken 的詳細資訊，請參閱一節。

備註

NDK_SGE 結構會指定傳送、接收、讀取和寫入工作要求的本機緩衝區。

當 MemoryRegionToken 成員設定為 NdkGetPrivilegedMemoryRegionToken (NDK_FN_GET_PRIVILEGED_MEMORY_REGION_TOKEN) 傳回的令牌時， NDK_SGE 必須包含 NdkBuildLam ( (NDK_FN_BUILD_LAM) 函式具有 NDK_LOGICAL_ADDRESS_MAPPING 結構的邏輯位址。請注意，NDK_LOGICAL_ADDRESS_MAPPINGAdapterPageArray 成員中的連續專案不一定是配接器邏輯位址空間中的連續頁面。因此，NDK 取用者可能會使用多個 SCE 來涵蓋配接器頁面陣列中的所有頁面。

當 MemoryRegionToken 成員中的令牌不等於 NdkGetPrivilegedMemoryRegionToken 所傳回的令牌時， NDK_SGE 結構必須包含落在先前註冊記憶體區域的虛擬位址範圍內。

當 NDK_SGE 結構用於具有 NDK_OP_FLAG_INLINE 旗標的工作要求中時， MemoryRegionToken 中的令牌可能無效，因此 NDK 提供者必須忽略它。指定NDK_OP_FLAG_INLINE旗標時，任何傳遞至工作要求函式之NDK_SGE結構的 VirtualAddress 成員都必須指向 NDK 提供者可存取的緩衝區，該緩衝區必須小於或等於DISPATCH_LEVEL，也就是說，緩衝區必須保證會駐留在物理記憶體中，直到工作要求函式傳回為止。在單一呼叫中傳遞至提供者的內嵌數據大小總計不能超過在建立 QP) (佇列配對時所指定的 InlineDataSize 參數中的值。

規格需求

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