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 傳輸。
要求
要求 | 價值 |
---|---|
目標平臺 | 普遍 |
標頭 | storport.h (包括 Storport.h) |
連結庫 | Storport.lib |