NdisMRegisterIoPortRange

NDIS_STATUS NdisMRegisterIoPortRange( OUT PVOID *PortOffset, IN NDIS_HANDLE MiniportAdapterHandle, IN UINT InitialPort, IN UINT NumberOfPorts );

NdisMRegisterIoPortRange는 NdisRawReadPortXxx 와 NdisRawWritePortXxx 함수들로 장치 I/O 포트들에게 드라이버 접근을 설정하고 그러한 드라이버의 NIC을 위해 레지스트리 내에 I/O 포트 주소들의 범위를 요구한다.

매개변수

PortOffset

이 함수는 InitialPort 와 NumberOfPorts에 의해 지정된 주어진 버스 관련 I/O 포트 범위를 위한 맵된 기본 가상 주소를 리턴한다.

MiniportAdapterHandle

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

InitialPort

맵된 포트 범위를 위해서 버스 관련 베이스 포트 주소를 지정한다.

NumberOfPorts

맵된 범위내에서 포트들의 수를 지정한다.

리턴값

NdisMRegisterIoPortRange는 다음과 같은 하나의 값을 리턴할 수 있다.

NDIS_STATUS_SUCCESS

I/O 포트들의 주어진 범위에서 성공적으로 맵되어지고 그래서 PortOffset에 값은 유효하고 맵된 범위는 NIC을 위해 레지스트리내에서 요구되어질 것이다.

NDIS_STATUS_RESOURCE_CONFLICT

또 하나의 드라이버가 이미 그 장치를 위해 범위를 요구했기 때문에 레지스트리내에서 I/O 포트 범위를 요구하는 시도가 실패했다. NdisMRegisterIoPortRange는 만약 이것이 발생하면은, 에러를 로그한다.

NDIS_STATUS_RESOURCES

포트 범위는 하드웨어 자원 충돌들을 위해 레지스트리를 체크하기 위해 포트 범위가 맵되어질 수 없거나 NDIS가 자원들을 할당할 수 없다.

NDIS_STATUS_FAILURE

버스 타입 혹은 버스 넘버는 범위를 벗어나거나 혹은 주어진 InitialPort와 NumberOfPorts가 유효하지 않다.(가능하다면은, 현 플랫폼의 I/O 포트 공간내에 없다.)

주석

NIC 드라이버는 MiniportInitialize 함수로부터 NdisMRegisterIoPortRange 함수를 호출한다. MiniportInitialize 함수는 NdisMRegisterIoPortRange 함수를 호출하기 전에 NdisMSetAttributes 혹은 NdisMSetAttributesEx를 호출해야 한다.

NdisMRegisterIoPortRange 함수는 미니포트가 계속해서 NdisRawXxx 함수들을 호출함으로써 NIC에서 I/O 포트 범위를 접근하기 위해 사용할 수 있는 버스 관련 장치 주소 범위를 맵한다. 성공적인 호출은 호출자의 NIC을 위해 레지스트리 내에서 특정한 I/O 포트 범위들의 범위를 요구할 수 있다.

NdisRawXxx 함수들로 전달되는 매개변수들이 맵되어지기 때문에, 이러한 함수들은 의미적으로 응답하는 NdisImmediate...PortXxx 함수보다 더 빠르게 실행한다. NdisMRegisterIoPortRange에 대한 성공적인 호출 후에, 미니포트는 버스 관련 주소들 혹은 그러한 I/O 포트 범위내에서 맵된 가상 주소들로 어떤 NdisImmediate..PortXxx 함수들을 호출할 수 없다.

만약 NdisMRegisterPortRange에 대한 호출이 실패한다면은, MiniportInitialize 함수는 이미 NIC을 위해 할당된, 그리고 그러한 NIC을 위한 초기화가 실패한다면은, 모든 자원들을 해제해야 한다.

호스트 메모리 공간내에서 장치 레지스터들로 NIC들의 드라이벋르은 NdisMMapIoSpace를 호출하고 계속해서, NIC 레지스터들을 접근하기 위해 NdisRead/WriteRegisterXxx 함수들을 호출한다.

NdisMRegisterIoPortRange의 호출자들은 IRQL PASSIVE_LEVEL에서 호출한다.