NdisMStartBufferPhysicalMapping
VOID
NdisMStartBufferPhysicalMapping(
IN NDIS_HANDLE MiniportAdapterHandle,
IN PNDIS_BUFFER Buffer,
IN ULONG PhysicalMapRegister,
IN BOOLEAN WriteToDevice,
OUT PNDIS_PHYSICAL_ADDRESS_UNIT PhysicalAddressArray,
OUT PUINT ArraySize
);
|
매개변수
- MiniportAdapterHandle
- MiniportInitialize 함수에 대한 입력 핸들을 지정한다.
- Buffer
- 전송을 위해 가상 범위를 맵핑하는 버퍼 디스크립터를 가리킨다. 이 버퍼는 전송된 데이터를 포함한다.
- PhysicalMapRegister
- 전송을 위해 사용된 맵 레지스터의 0토대 인덱스를 지정한다. 이 값은 드라이버가 NdisMAllocateMapRegisters로 초기화하는 동안 할당된 맵 레지스터들보다 작은 수보다 더 클 수 없을 것이다.
- WriteToDevice
- 맵핑이 NIC을 통해 시스템으로부터 outbound 전송을 위해 사용될 때 TRUE를 지정한다.
- PhysicalAddressArray
- 각 요소는 다음과 같이 정의되어지는데 NDIS_PHYSICAL_UNIT 구조체들의 호출자 제공 배열을 가리킨다.
typedef struct _NDIS_PHYSICAL_ADDRESS_UNIT {
NDIS_PHYSICAL_ADDRESS PhysicalAddress;
UINT Length;
} NDIS_PHYSICAL_ADDRESS_UNIT, *PNDIS_PHYSICAL_ADDRESS_UNIT;
NdisMStartBufferPhysicalMapping에 대한 성공적인 호출로부터 리턴되자마자, 이러한 배열내에 요소들은 각 요소들내에서 다음과 같은 멤버들로 NIC에 다운로드되어지는데 적당한 맵된 논리 범위들을 지정한다.
- PhysicalAddress
- 전송되어지는 분산 연산 범위의 데이터의 시작을 위한 베이스 물리 주소를 지정한다.
- Length
- 맵된 범위내에서 바이트 수들을 지정한다.
- ArraySize
- NdisMStartBufferPhysicalMapping은 PhysicalAddressArrary에서 버퍼내에 맵된 범위들 수를 리턴하는 호출자 제공 변수를 가리킨다. 이 값은 맵핑들을 포함하는 요소들의 카운트이다, 그래서 호출자는 계속해서 NIC에서 다운로드하는 실제 주소 범위들의 수로 바운드(bound)로서 이러한 카운트를 사용할 수 있다.
주석
버스마스터 NIC 드라이버들은 NIC과 바운드된 프로토콜들로 향하는(originating) 요구들을 보내는 것에 대한 응답으로 NdisMStartBufferPhysicalMapping 함수를 호출한다. 즉, Buffer에 버퍼 디스크립터는 NIC 드라이버의 MiniportSend 혹은 MiniportSendPackets 함수에 대한 패킷 입력과 연결되어진다.
모든 프로토콜 드라이버는 아래 NIC의 제한들을 suit하기위해 보내기 패킷들을 설정하는 책임이 있다. NIC 드라이버의 MiniportQueryInformation 함수는 이미 어떤 OID_GEN_XXX 요구들에 대한 응답으로 이러한 제한들을 리턴한다. 결과적으로, 미니포트는 너무 큰 크기의 프레임들 혹은 전송 블럭들을 위한 혹은 전송 버퍼 오퍼플로우를 윟나 들어오는 보내기 패킷들을 테스트할 필요가 없다. OID 들의 대한 더 많은 정보를 위해서, Part 2를 봐라.
NdisMStartBufferPhysicalMapping의 호출자는 PhysicalAddressArray인 배열은 주어진 버퍼를 맵하기 위해 충분하도록 하는 것을 확실히 해야 한다. 미니포트는 얼마나 많은 요소들이 Buffer에 디스크립터내에 지정된 가상 범위를 맵하기 위해 요구되어지는 지를 결정하기 위해 NdisGetBufferPhysicalArraySize 함수를 호출할 수 있다.
길이가 256K까지와 같은, 작은 전송 요구들을 위해, 미니포트는 NdisMAllocateSharedMemory 혹은 NdisMAllocateSharedMemoryAsync 함수로 이미 할당된 공유 메모리 공간내에서 staging 버퍼로 전송되어지는 데이터를 복사함으로써 더 높은 퍼포먼스를 성취할 수 있다. NIC 드라이버가 이미 그러한 맵된 메모리 범위를 위해 가상 과 실제 주소들을 맵했기 때문에, 그러한 조마한 DMA 전송들을 위해 NdisM...BufferPhysicalMapping 함수들을 호출할 필요는 없다.
버스마스터 NIC에 의해 수신된 데이터는, 미니포트에 의해 할당된 공유된 메모리 블럭내에 장치접근할 수 있는 버퍼들로 직접 전송되어진다. 미니포트들은 외연적으로 전송들을 위해 단지 버스마스터 DMA 연산들을 행한다.
보내기 요구를 위해 패킷 데이터를 전송하기 위해, 어떤 미니포트는 기본적으로 다음과 같은 일을 한다.
- NIC에 의해 사용을 위한 맵된 장치 접근할 수 있는 범위 주소들을 얻기 위해 NdisMStartBufferPhysicalMapping 함수로 데이터를 포함한 가상 범위를 맵한다.
- NIC에 대한 리턴된 실제 주소들을 다운로드한다.
- 만약 드라이버가 캐쉬화된 메모리를 할당한다면은 NdisFlushBuffer와 NdisMUpdateSharedMemory를 호출한다.
- 전송 연산을 위해 NIC을 프로그램한다.
- NIC이 전송을 완료할 때, NIC이 전송 인터럽트에 의해 혹은 NIC 드라이버의 폴링 MiniportTimer 함수에 의해 발견된 상태 변화에 의해 인디케이트 하는 것이 어느 것인지 MiniportHandleInterrupt 함수로부터 항상 NdisMCompleteBufferPhysicalMapping 함수를 호출한다.
NdisMStartBufferPhysicalMapping에 의해 리턴된 어떤 맵핑은 단지 미니포트가 NdisMCompleteBufferPhysicalMapping 함수를 호출할 때까지 유효하다. NdisMCompleteBufferPhysicalMapping 함수가 제어를 리턴할 때, NdisMStartBufferPhysicalMapping 함수에 대한 선행 호출에서 지정된 PhysicalMapRegisters는 계속해서 DMA연산에서 재사용될 수 있다.
NdisMStartBufferPhysicalMapping의 호출자들은 IRQL <= DISPATCH_LEVEL에서 실행한다.
|