Share via


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 set to TRUE, NumberOfPhysicalBreaks, AdapterInterfaceType, Dma32BitAddresses, Dma64BitAddresses, SystemIoBusNumber, AutoRequestSenseSrbExtensionSize 멤버를 채워야 합니다.

EISA 버스 master 어댑터의 DmaChannel과 같이 HBA와 관련이 없는 멤버는 그대로 두어야 합니다.

NumberOfBytes

할당할 캐시되지 않은 확장의 필요한 크기(바이트)입니다.

반환 값

StorPortGetUncachedExtension 은 캐시되지 않은 확장에 대한 가상 주소 포인터를 반환합니다. 요청된 메모리를 할당할 수 없는 경우 NULL을 반환합니다. 메모리가 이전에 할당된 경우 현재 캐시되지 않은 확장에 대한 가상 주소 포인터가 반환됩니다.

설명

버스 master 디바이스는 DMA 전송에 공통 버퍼 공간을 사용합니다.

요구 사항

요구 사항
대상 플랫폼 유니버설
헤더 storport.h(Storport.h 포함)
라이브러리 Storport.lib

추가 정보

ScsiPortGetUncachedExtension