共用方式為

StorPortGetUncachedExtension 函式 (storport.h)

  • 發行項

StorPortGetUncachedExtension 例程會配置 CPU 和裝置所共用的未快取通用緩衝區。

語法

STORPORT_API PVOID StorPortGetUncachedExtension(
  PVOID                           HwDeviceExtension,
  PPORT_CONFIGURATION_INFORMATION ConfigInfo,
  ULONG                           NumberOfBytes
);

參數

HwDeviceExtension

硬體裝置擴充功能的指標。 這是每個 HBA 儲存區域，埠驅動程式會代表迷你埠驅動程式配置和初始化。 迷你埠驅動程式通常會將此擴充功能中儲存 HBA 特定資訊，例如 HBA 的狀態和 HBA 的對應存取範圍。 此區域可在迷你埠驅動程式呼叫 StorPortInitialize 之後立即提供給迷你埠驅動程式。 埠驅動程式會在移除裝置時釋放此記憶體。

ConfigInfo

指定 HBA 的 DMA 功能相關信息。 下列成員必須填入：DmaChannel 或 DmaPort、 DmaWidth、DmaSpeed、MaximumTransferLength、ScatterGather、Master 設定為 TRUE、NumberOfPhysicalBreaks、AdapterInterfaceType、Dma32BitAddresses、Dma64BitAddresses、SystemIoBusNumber、AutoRequestSense 和 SrbExtensionSize。

與 HBA 不相關的成員，例如 EISA 總線主機適配卡的 DmaChannel ，必須保持原狀。

NumberOfBytes

要配置的未快取擴充功能所需的大小，以位元組為單位。

傳回值

StorPortGetUncachedExtension 會傳回未快取延伸模組的虛擬位址指標。 如果它無法配置要求的記憶體，則會傳回 NULL。 如果先前已配置記憶體，則會傳回目前未快取擴充功能的虛擬位址指標。

備註

總線主機裝置會針對 DMA 傳輸使用通用緩衝區空間。

規格需求

需求 值
目標平台 Universal
標頭 storport.h (包含 Storport.h)
程式庫 Storport.lib

另請參閱

ScsiPortGetUncachedExtension