NdisMMapIoSpace
NDIS_STATUS
NdisMMapIoSpace(
OUT PVOID *VirtualAddress,
IN NDIS_HANDLE MiniportAdapterHandle,
IN NDIS_PHYSICAL_ADDRESS PhysicalAddress,
IN UINT Length
);
|
NdisMMapIoSpace 함수는 시스템 공간 가상 범위에 장치 램 혹은 레지스터들의 주어진 버스 관련 범위를 맵한다.
매개변수
- VirtualAddress
- 만약 호출이 성공적이라면은, 변환된 가상 주소를 설정하는 호출자 제공 변수를 가리킨다.
- MiniportAdapterHandle
- MiniportInitialize에 대한 핸들 입력을 지정한다.
- PhysicalAddress
- 맵된 장치 메모리 범위의 버스 관련 베이스 실제 주소를 지정한다.
- Length
- 맵된 바이트 수를 지정한다.
리턴값
NdisMMapIoSpace는 다음과 같은 상태 값들 중에 하나를 리턴한다. :
- NDIS_STATUS_SUCCESS
- 장치 메모리 범위는 성공적으로 맵되어진다. 그래서 VirtualAddress는 유효하고 맵된 범위는 NIC을 위해 레지스트리내에 요구되어진다.
- NDIS_STATUS_RESOURCE_CONFLICT
- 또 하나의 드라이버가 이미 장치를 위해 범위를 요구했기 떄문에 레지스트리내에 장치 메모리 범위를 요구하는 시도는 실패했다. 만약 이것이 일어나면은 NdisMMapIoSpace는 에러를 로그한다.
- NDIS_STATUS_RESOURCES
- 메모리가 맵되어지지 않거나 혹은 충분한 가상 메모리가 할당되어지지 않는다.
- NDIS_STATUS_FAILURE
- 버스 타입 혹은 버스 넘버가 범위 밖에있든지 혹은 주어진 PhysicalAddress 와 Length가 유효하지 않다. (가능한 한 현 플랫폼의 I/O 공간내에 없다.)
주석
이 함수는 on-board메모리 혹은 호스트의 I/O 공간내에 나타나는 장치 레지스터들의 뱅크를 가지는 NIC들의 드라이버들에 의해 호출되어진다. 예로 PIO를 사용하는 NIC의 드라이버는 NdisMMapIoSpace를 호출한다.
NdisMMapIoSpace에 대한 성공적인 호출은 드라이버의 NIC을 위해 레지스트리내에 하드웨어 자원들을 요구한다. 결과적으로, 단지 MiniportInitialize 함수들은 NdisMMapIoSpace를 호출한다. NdisMMapIoSpace는 만약 NDIS_STATUS_SUCCESS로 리턴하지 않는다면은 VirtualAddress에 변수는 NULL로 설정한다.
MiniportInitialize 함수는 드라이버의 Parameters 레지스트리 키로부터 PhysicalAddress 값을 얻거나 혹은 버스 타입 특정 NdisXxx 구성 함수를 호출함으로써 PhysicalAddress 값을 얻는다. 주어진 물리 주소 범위는 현 플랫폼의 I/O 공간내에 떨어져야 한다.(fall) 호스트 물리적인 메모리 주소로 NdisMMapIoSpace를 호출하는 것은 프로그래밍 에러이다.
미니포트는 만약 MiniportInitialize 함수가 계속해서 NIC을 초기화하는 것을 실패한다면은, 만약 NIC이 기계로부터 제거된다면은, 혹은 드라이버가 unloading 할때, 상호적인(reciprocal) NdisMUnmapIoSpace를 호출해야 한다.
NdisMMapIoSpace의 호출자들은 IRQL PASSIVE_LEVEL에서 실행한다.
|