NdisMAllocateSharedMemory

VOID NdisMAllocateSharedMemory( IN NDIS_HANDLE MiniportAdapterHandle, IN ULONG Length, IN BOOLEAN Cached, OUT PVOID *VirtualAddress, OUT PNDIS_PHYSICAL_ADDRESS PhysicalAddress );

NdisMAllocateSharedMemory는 호스트 메모리 범위를 할당하고 맵한다. 그래서 동시에 시스템과 버스마스터 DMA NIC으로부터 접근할 수 있다.

매개변수

MiniportAdapterHandle

MiniportInitialize에 대한 핸들 입력을 지정한다.

Length

할당할 바이트 수들을 지정한다.

Cached

만약 메모리 범위가 캐쉬화된 메모리로부터 할당될 수 있다면은 TRUE를 지정한다.

VirtualAddress

이 함수는 미니포트에 의해 사용하기 위한 할당의 베이스 가상 주소를 리턴하는 호출자 제공 변수를 가리킨다. 만약 NdisMAllocateSharedMemory 함수가 호출자를 만족할 수 없다면은, 메모리가 할당되지 않았다는 것을 가리키는 NULL을 리턴한다.

PhysicalAddress

이 함수는 VirtualAddress에 리턴하는 것에 대해 응답하는 NIC에 의해 사용을 위해 적당한 실제 주소를 리턴하는 호출자 제공 변수를 가리킨다. 혹은 NULL을 리턴하는

주석

NdisMAllocateSharedMemory는 드라이버가 공유 메모리 블럭에 접근하기 위해 사용하는 맵된 가상 주소 범위와 NIC이 사용하는 NDIS_PHYSICAL_ADDRESS 타입 범위을 제공한다. PhysicalAddress에 리턴된 값은 2중으로(doubly) 시스템에 의해 맵되어질 수 있다. 즉, PhysicalAddress와 Length에 값에 의해 설명된 실제("physical") 주소 범위는 모든 가능한 플랫폼에서 할당을 위해 호스트 물리적인 주소와 일치하지 않는 맵된 논리적인 주소들의 범위가 될 수 있다.

NdisMAllocateSharedMemory는 단지 MiniportInitialize 함수로부터 호출되어질 수 있다. 요구되어지는 것이 얼마나 많이 할당되어지는 가는 드라이버 개발자가 NIC의 특징들과 능력들을 알고 있는, 다음과 같은 퍼포먼스와 크기 딜레마사이에 절충(tradeoff)을 학 위해 결정되지는 것에 의존한다.

• 고속 네트워크 트래픽의 시기에서, 미니포트는 만약 장치가 접근할 수 있는 데이터 버퍼들을 위해 공유된 메모리 공간이 너무 작다면은 높은 I/O throughput을 유지할 수 없다.

  예를 들어, 미니포트는 그러한 버퍼들이 많은 수신들이 NIC에 들어올 때 바인드된 프로토콜로부터 리턴되어지는 것보다 빠르게 공유 메모리내에 수신 버퍼들을 인디케이트할 수 있다. 만약 모든 공유된 메모리 공간이 나타나는(outstanding) 수신 버퍼들에 의해 소비되어진다면은, 미니포트는 수신 버퍼들을 위해 이용할 수 있는 몇몇 공유된 메모리 공간을 가질 때까지 NIC에게 수신 인터럽트들을 불가능하게 해야 한다.

• 반면, 몇몇 최대 전송(transfer : 수신) 요구를 기대하기 위해 선택한 Length로 NdisMAllocateSharedMemory를 호출하는 것은 드라이버의 이미지를 더 크게 만들고 더 높은 I/O 요구의 드문(rare) 경우들(periods)을 제외하고 비경제적이다. 더우기, NdisMAllocateSharedMemory는 만약 불충분한 시스템 메모리가 드라이버가 강제적으로 초기화를 실패할 때 이용할 수 있다면은, 그러한 더 큰 블럭을 제공하지 않을 것이다.

NdisMAllocateSharedMemory 와 NdisMAllocateSharedMemoryAsync는 단지 가상 메모리를 사용하는 드라이버와 응답하는 논리 주소들을 사용하는 버스마스터 NIC 사이에서 공유되는 호스트 메모리를 할당하기 위해 호출되어질 수 있는 NdisXxx 함수들이다.

가능할 때마다, NIC 드라이버는 요구가 성공적이기 때문에 Cached가 TRUE로 NdisMAllocateSharedMemory를 호출한다. 어떤 플랫폼에서, 비캐쉬화된 메모리는 항상 scarce 시스템 자원이다. 항상, 드라이버들은 마찬가지로 캐쉬화된 메모리로부터 더 큰 할당들을 얻을 수 있다. NIC 드라이버는 만약 다음과 같은 것이 사실이라면은 비캐쉬화된 메모리로부터 공유된 메모리 공간을 할당해야 한다:

• NIC 혹은 미니포트는 직접 미니포트가 새롭게 수신된 데이터를 인디케이트하기 전에 수신 버퍼들에 쓴다.

  예를 들어, 전송되어진 후에 각 수신된 프레임내에서 플래그들을 설정하는 NIC은 비캐쉬화된 메모리내에 수신 버퍼들에 대한 접근을 가져야 한다. 그렇지 않는다면은, 미니포트는 캐쉬 유착(coherency)을 유지하기 위해 플러쉬(flush)를 발생해야 할 때를 결정하지 않는다. 미니포트는 또한 캐쉬화된 버퍼를 플러쉬(flush)하기 위한 실패 안전 간격을 위해 기다림으로써 퍼포먼스 hit를 가질 것이거나 혹은 미니포트는 프레임 플래그들이 랜덤하게 설정되는 것에 대해 인디케이션할 것이다.

• NIC은 연속적으로 공유 메모리 공간내에 연속적인 실제 메모리내로 몇몇 수신 버퍼들을 전송한다.(transfer)

  만약 그러한 NIC이 들어오는 프레임들을 연속적인 캐쉬화된 메모리내에 전송한다면은, 드라이버는 어떤 프레임이 캐쉬라인 경계를 건너야(straddle)할 때 모든 그러한 프레임들을 위해 데이터 무결성을 유지할 수 없다. 미니포트가 그러한 프레임을 위한 범위를 플러쉬(flush)할 때, 또한 만약 이미 전송되었다면은 그러므로 그러한 다음 프레임이 유착되지 않으므로(incoherent) 몇몇 다음 플레임을 포함하는 캐쉬 공간을 플러쉬할 것이다.

MiniportInitialize 함수는 드라이버가 공유된 메모리의 할당된 범위내에서 설정할 장치 접근 버퍼들을 위해 현재 플랫폼내에서 정렬 경계를 결정하기 위해 NdisGetCacheFillSize를 호출할 수 있다.

MiniportInitialize 함수는 또한 만약 드라이버 개발자가 어떤 SMP 기계가 워크스테이션보다 NIC에 대한 더 높은 네트워크 전송 요구들을 가진 네트워크 서버가 될거라고 추측한다면은 멀티프로세서 기계들에서 더 큰 공유된 메모리 블럭을 할당하기 위해 결정한다면은 NdisMAllocateSharedMemory를 호출하기 전에 NdisSystemProcessCount를 호출할 것이다.

MiniportInitialize 함수는 NdisMAllocateSharedMemory를 호출하기 전에 NdisMAllocateMapRegisters를 호출해야 한다. 그렇지 않으면은, 메모리가 할당되지 않을 것이다. NDIS는 할당될 때 공유된 메모리 범위를 위해 내부적으로 추가적으로 맵 레지스터를 할당한다.

만약 MiniportInitialzie 함수가 NIC이 NdisMSetAttributes 혹은 NdisMSetAttributesEx 를 호출할 때, 버스마스터라는 것을 지정하지 않는다면은, NdisMAllocateSharedMemory를 간단하게 할당하는 것을 시도하는 것 없이 제어를 리턴한다.

만약 NdisMAllocateSharedMemory에 대한 호출이 실패한다면은, MiniportInitialize 함수는 다시 더 조금만한 할당을 요구하기 위해 호출할 수 있다. 그러나 만약 MiniportInitialize는 NIC을 위해 충분한 공유된 메모리를 할당할 수 없다면은 이미 할당된 모든 자원들을 해제해야 하고 초기화는 실패한다.

만약 NIC 드라이버는 계속해서 NdisMIndicateReceivePacket로 수신들을 인디케이트한다면은, 공유된 메모리 블럭내에서 NIC의 수신 버퍼들을 맵하기 위해 버퍼 풀(pool)로부터 몇몇 버퍼 디스크립터들을 할당해야 한다.

만약 할당된 메모리가 캐쉬화되고 그러므로, 전송들에 대해 플러쉬되어질 필요가 있다면은, 미니포트는 공유된 메모리 범위를 위해 NDIS_BUFFER 타입 디스크립터를 할당하기 위해 NdisAllocateBuffer를 호출해야 한다. NIC 드라이버는 그러한 플러쉬를 행하기 위해 이러한 버퍼 디스크립터로 NdisFlushBuffer 를 호출해야 한다. 추가적으로, 그러한 미니포트는 모든 가능한 플랫폼들에서 데이터 무결성을 확실히 하기 위해 NdisMUpdateSharedMemory를 호출해야 한다.

NdisMAllocateSharedMemoryAsync 혹은 NdisMAllocateSharedMemory를 호출하는 어떤 미니포트는 NIC이 제거될 때, 즉 MiniportHalt가 호출되어질 때, NdisMFreeSharedMemory에 대한 하나나 혹은 그 이상의 호출로 모든 발생하는 할당들을 해제해야 한다.

NdisMAllocateSharedMemory의 호출자들은 IRQL PASSIVE_LEVEL를 실행한다.