NdisQueryMapRegisterCount

NDIS_STATUS NdisQueryMapRegisterCount( IN NDIS_INTERFACE_TYPE BusType, OUT PUINT MapRegisterCount );

NdisQueryMapRegisterCount 함수는 시스템에 있는 맵 레지스터의 전체 수를 리턴한다.

매개변수

BusType

호출자의 버스마스터 DMA NIC의 I/O 버스 인터페이스 타입을 서술한다. 보통 다음중에 하나로 NIC이 연결되는 I/O 버스의 타입이다:

NdisInterfaceInternal

호스트 특정 내부 인터페이스를 서술한다.

NdisInterfaceIsa

ISA 인터페이스를 서술한다.

NdisInterfaceEisa

확장된 ISA(EISA) 인터페이스를 서술한다.

NdisInterfaceMca

이것은 더이상 지원되지 않는 MCA 버스를 언급한다.

NdisInterfaceTurboChannel

터보 채널 인터페이스를 서술한다.

NdisInterfacePci

PCI 인터페이스를 지원한다.

NdisInterfacePcMcia

퍼스널 컴퓨터 메모리 카드 인터내셔널 관련(PC Card) 인터페이스를 서술한다.

MapRegisterCount

시스템에 있는 맵 레지스터의 전체 수를 리턴하는 이 함수의 호출자 제공 변수를 가리킨다. 이 수는 호출자에 의해서 이용될 수 있는 맵 레지스터와 다른 드라이버에 의해서 예약된 맵 레지스터를 포함한다. MapRegisterCount는 호출자에게 이용될 수 있는 맵 레지스터의 전체 수를 인디케이트하지 않는다.

리턴값

MapRegisterCount의 값이 유효하다면 NdisQueryMapRegisterCount 함수는 NDIS_STATUS_SUCCESS를 리턴한다; 그렇지 않으면 NDIS_STATUS_NOT_SUPPORTED를 리턴한다.

주석

NdisQueryMapRegisterCount 함수는 버스마스터 DMA 장치의 드라이버에게만 사용할 수 있는 정보를 리턴한다. MapRegisterCount는 시스템에 있는 이용할 수 있는 맵 레지스터의 전체 수를 서술한다. 이 맵 레지스터의 몇몇 혹은 전체는 다른 드라이버에 의해서 예약된다. 호출자는 얼마나 많은 매 레지스터를 사용할 수 있는지를 알기 위해서 이 카운트를 사용해야한다.

버스마스터 NIC 미니포트는 초기화 동안에만 NdisQueryMapRegisterCount 함수를 호출할 수 있다. 그러한 드라이버의 MiniportInitialize 함수는 NdisMAllocateMapRegisters 함수를 호출하기 전에 NdisQueryMapRegisterCount 함수를 호출해야한다.

NdisQueryMapRegisterCount 함수의 호출자는 IRQL PASSIVE_LEVEL에서 실행된다.