NdisMSetAttributes
VOID
NdisMSetAttributes(
IN NDIS_HANDLE MiniportAdapterHandle,
IN NDIS_HANDLE MiniportAdapterContext,
IN BOOLEAN BusMaster,
IN NDIS_INTERFACE_TYPE AdapterType
);
|
NdisMSetAttributes 함수는 초기화 동안에 호출자 NIC의 중요한 특징에 대해서 NDIS 라이브러리에게 알린다.
매개변수
- MiniportAdapterHandle
- MiniportInitialize 함수로 입력되는 핸들을 서술한다.
- MiniportAdapterContext
- MiniportInitialize 함수에 의해서 할당된 존재하는 컨텍스트 지역에 대한 핸들을 서술한다.
- BusMaster
- 호출자의 NIC이 버스마스터 DMA 장치라면 TRUE를 서술한다.
- AdapterType
- NIC이 연결됐을 때 다음과 같은 I/O 버스 타입의 호출자 NIC의 I/O 버스 인터페이스 타입을 서술한다:
- NdisInterfaceInternal
- 호스트 특정 내부 인터페이스를 서술한다.
- NdisInterfaceIsa
- ISA 인터페이스를 서술한다.
- NdisInterfaceEisa
- 확장된 ISA (EISA) 인터페이스를 서술한다.
- NdisInterfaceMca
- 이것은 더이상 지원되지 않는 MCA 버스를 언급한다.
- NdisInterfaceTurboChannel
- 터보 채널 인터페이스를 서술한다.
- NdisInterfacePci
- PCI 인터페이스를 서술한다.
- NdisInterfacePcMcia
- 퍼스널 컴퓨터 메모리 카드 인터내션널 협회(PC Card) 인터페이스를 서술한다.
주석
MiniportInitialize 함수는 NdisMSetAttributes(Ex) 함수로 제공되는 정보에 의존하는 NdisMRegisterXxx나 NdisXxx 함수를 호출하기 전에 NdisMSetAttributes나 NdisMSetAttributesEx 함수를 호출해야한다. 예를들어 MiniportInitialize 함수가 BusMaster가 TRUE로 설정된 NdisMSetAttributes 함수를 아직 호출하지 않았거나 AttributeFlags가 NDIS_ATTRIBUTE_BUS_MASTER로 설정된 NdisMSetAttributesEx 함수를 호출하지 않았다면 NdisMAllocateMapRegisters 함수의 호출은 실패할 것이다.
일반적으로 NIC 드라이버는 NIC을 위해서 레지스트리안에 하드웨어 자원을 요구하는 어떤 NdisXxx 함수를 호출하기 전에 NdisMSetAttributes(Ex) 함수를 호출해야한다. 왜나하면 NDIS는 그러한 호출이 일어나기 전에 BusMaster나 AttributeFlags 값을 가지고 있어야하기 때문이다. 그리고 드라이버는 이 호출에 대한 정보를 저장하는 MiniportAdapterContext에 메모리를 필요로하기 때문이다. 이러한 제한은 NIC 드라이버의 MiniportInitialize 함수가 NdisMSetAttributes(Ex) 함수를 호출하기 전에 다음의 NdisXxx 함수를 호출할 수 없음을 암시한다:
- NdisMPciAssignResources
- NdisMAllocateMapRegisters와 NdisMAllocateSharedMemory
- NdisMMapIoSpace와 그에 따른 Ndis..RegisterXxx 함수들
- NdisMRegisterDmaChannel
- NdisMRegisterInterrupt
- NdisMRegisterIoPortRange와 그에 따른 NdisRaw..PortXxx 함수들
그러나 NdisMSetAttributes(Ex) 함수를 호출하기 전에 NIC 드라이버는 레지스트리안에 그리고 NdisImmediate..PortXxx 함수와 마찬가지로 NdisImmediateReadPciSlotInformation 혹은 NdisImmediateReadSharedMemory 함수같은 NdisImmediateXxx 함수에 설치된 구성 정보를 얻기 위해서 Ndis..Configuration 함수를 호출할 수 있다. 또한 MiniportInitialize 함수는 드라이버의 인터페이스 타입을 위해서 설치된 레지스트리 엔트리가 MiniportInitialize 함수가 호출하는 버스 타입 특정 NdisReadXxx 함수와 적절하게 어울리는 한 NdisReadPciSlotInformation 함수처럼 버스 타입 특정 NdisReadXxx 함수를 호출할 수 있다.
NdisMSetAttributes(Ex) 함수에서 제공된 MiniportAdapterContext 핸들은 NdisMRegisterMiniport 함수의 호출에서 등록된 MiniportInitialize 함수를 따르는 모든 MiniportXxx 함수의 입력 매개변수가 된다. 보통 이 핸들은 MiniportInitialize 함수에 의해서 할당된 NIC 특정 런타임 상태를 유지하는 드라이버안에 존재하는 메모리에 대한 포인터이다.
인터미디엇 드라이버는 NdisMSetAttributes 함수보다는 NdisMSetAttributesEx 함수를 호출해야한다. NIC 드라이버는 이 함수중 하나를 호출할 수 있다. 하지만 NdisMSetAttributesEx 함수는 미니포트로 하여금 MiniportCheckForHang이나 MiniportReset 함수가 호출될 때로 간격을 적용하게 한다.
NdisMSetAttributes 함수의 호출자는 IRQL PASSIVE_LEVEL에서 실행한다.
|