Fungsi StorPortGetUncachedExtension (storport.h)

Rutinitas StorPortGetUncachedExtension mengalokasikan buffer umum yang tidak di-cache untuk dibagikan oleh CPU dan perangkat.

Sintaks

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

Parameter

HwDeviceExtension

Penunjuk ke ekstensi perangkat keras. Ini adalah area penyimpanan per HBA yang dialokasikan dan diinisialisasi driver port atas nama driver miniport. Driver miniport biasanya menyimpan informasi khusus HBA dalam ekstensi ini, seperti status HBA dan rentang akses yang dipetakan untuk HBA. Area ini tersedia untuk driver miniport segera setelah driver miniport memanggil StorPortInitialize. Driver port membebaskan memori ini ketika melepas perangkat.

ConfigInfo

Menentukan informasi tentang kemampuan DMA HBA. Anggota berikut harus diisi: DmaChannel atau DmaPort, DmaWidth, DmaSpeed, MaximumTransferLength, ScatterGather, Master diatur ke TRUE, NumberOfPhysicalBreaks, AdapterInterfaceType, Dma32BitAddresses, Dma64BitAddresses, SystemIoBusNumber, AutoRequestSense, dan SrbExtensionSize.

Anggota yang tidak berkaitan dengan HBA, seperti DmaChannel untuk adaptor master bus EISA, harus dibiarkan apa adanya.

NumberOfBytes

Ukuran yang diperlukan, dalam byte, dari ekstensi yang tidak di-cache untuk dialokasikan.

Nilai kembali

StorPortGetUncachedExtension mengembalikan penunjuk alamat virtual ke ekstensi yang tidak di-cache. Jika tidak dapat mengalokasikan memori yang diminta, memori akan mengembalikan NULL. Jika memori sebelumnya dialokasikan, penunjuk alamat virtual ke ekstensi yang tidak di-cache saat ini dikembalikan.

Keterangan

Perangkat bus-master menggunakan ruang buffer umum untuk transfer DMA.

Persyaratan

Persyaratan	Nilai
Target Platform	Universal
Header	storport.h (termasuk Storport.h)
Pustaka	Storport.lib

Lihat juga

ScsiPortGetUncachedExtension