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, AutoRequestSense 및 SrbExtensionSize 멤버를 채워야 합니다.
EISA 버스 master 어댑터의 DmaChannel과 같이 HBA와 관련이 없는 멤버는 그대로 두어야 합니다.
NumberOfBytes
할당할 캐시되지 않은 확장의 필요한 크기(바이트)입니다.
반환 값
StorPortGetUncachedExtension 은 캐시되지 않은 확장에 대한 가상 주소 포인터를 반환합니다. 요청된 메모리를 할당할 수 없는 경우 NULL을 반환합니다. 메모리가 이전에 할당된 경우 현재 캐시되지 않은 확장에 대한 가상 주소 포인터가 반환됩니다.
설명
버스 master 디바이스는 DMA 전송에 공통 버퍼 공간을 사용합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 대상 플랫폼 | 유니버설 |
| 헤더 | storport.h(Storport.h 포함) |
| 라이브러리 | Storport.lib |