NdisMSetAttributesEx

VOID NdisMSetAttributesEx( IN NDIS_HANDLE MiniportAdapterHandle, IN NDIS_HANDLE MiniportAdapterContext, IN UINT CheckForHangTimeInSeconds OPTIONAL, IN ULONG AttributeFlags, IN NDIS_INTERFACE_TYPE AdapterType );

NdisMSetAttributesEx는 초기화하는 동안 가상 NIC 혹은 호출자의 NIC의 중요한 특징들에 대해 NDIS 라이브러리에게 알린다.

매개변수

MiniportAdapterHandle

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

MiniportAdapterContext

MiniportInitialize에 할당 상주 컨텍스트 영역을 위한 핸들을 지정한다.

CheckForHangTimeInSeconds

NDIS는 MiniportCheckForHang 함수를 호출해야 하는 초당 시간 간격을 지정한다. if any 이 매개변수를 0으로 지정하는 것은 NDIS가 NDIS의 디폴트 2초 간격으로 MiniportCheckForHang을 호출해야 하고 NDIS가 NDIS가 계속해서 호출자를 큐로 저장해서 유지하는 지연 보내기와 요구들을 위해 디폴트 4-2 타임 아웃 시간간격으로 MiniportReset 함수를 호출해야 하는 것을 지시한다.

2보다 더 높은 값을 지정하는 것은 checkforhang 그리고 timeout 간격들을 확장한다. NDIS는 호출자를 위한 타임아웃 간격으로 두배의 지정된 checkforhang 간격을 사용한다.

만약 호출자가 AttributeFlags로 NDIS_ATTRIBUTE_DESERIALIZE를 설정하면은, NDIS는 미니포트를 위해 지연된 보내기들을 큐로 저장하지 않는다. 그 대신에 그러한 비직렬화가 된 드라이버는 들어오는 보내기 패킷들을 즉시 전송하는데 불충분한 메모리를 가지고 있을 때마다 내부적으로 계속해서 보내기 요구들의 자신의 큐로 저장하는 것을 관리해야 한다.

AttributeFlags

다음 플래그들의 하나나 혹은 그 이상으로(ORed) 설정될 수 있는 비트마스크로 지정한다.

NDIS_ATTRIBUTE_BUS_MASTER

만약 호출자 NIC이 버스마스터 DMA 장치이면은 설정된다.

NDIS_ATTRIBUTE_DESERIALIZE

만약 호출자가 비직렬화 미니포트이면은 설정된다.

NDIS_ATTRIBUTE_IGNORE_PACKET_TIMEOUT

만약 NDIS가 호출자에게 큐에 저장된 상태로 유지하는 지연된 보내기 패킷들이 타임아웃되는 것을 시도하지 않으면은 설정된다. 직렬화된 인터미디엇 드라이버들은 이 플래그를 설정하지만은, NIC 드라이버들은 하지 말아야 한다.

NDIS_ATTRIBUTE_IGNORE_REQUEST_TIMEOUT

NDIS가 호출자에게 큐로 저장된 지연된 쿼리 설정 요구들을 타임아웃을 시도하지 않으면은 설정된다. 직렬화된 인터미디엇 드라이버들은 이 플래그를 설정해야 하지만은 NIC 드라이버는 하지 않는다.

NDIS_ATTRIBUTE_INTERMEDIATE_DRIVER

호출자가 인터미디엇 드라이버이면은 설정한다.

NDIS_ATTRIBUTE_IGNORE_TOKEN_RING_ERRORS

NDIS가 만약 Token Ring 에러들을 지시하지 않는다면은 Token Ring NIC 드라이버의 MiniportReset 함수를 호출하지 않는다면은 설정한다.

NDIS_ATTRIBUTE_NO_HALT_ON_SUSPENDED

만약 NDIS가 low-power(sleeping) 상태로의 시스템 이전전에 드라이버의 MiniportHalt 함수가 호출하지 않는다면은 설정한다. 하드웨어 유지 상태에 의존하는 드라이버들은 이 플래그를 설정하지 않는다.

AdapterType

NIC이 연결된 I/O 버스 타입인 호출자의 NIC의 I/O 버스 인터페이스 타입을 지정한다. 다음과 같은 값 중 하나가 된다.

NdisInterfaceInternal

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

NdisInterfaceIsa

ISA 인터페이스를 지정한다.

NdisInterfaceEisa

확장 ISA(EISA) 인터페이스를 지정한다.

NdisInterfaceMca

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

NdisInterfaceTurboChannel

Turbo Channel 인터페이스를 지정한다.

NdisInterfacePci

Peripheral Component Interconnect(PCI) 인터페이스를 지정한다.

NdisInterfacePcMca

Personal Computer Memory Card International Association(PC Card) 인터페이스를 지정한다.

이 매개변수는 이 매개변수가 NdisMSetAttributesEx로 0으로 전달해야 하는 인터미디엇 드라이버는 상관이 없다.

주석

MiniportInitialize 함수는 NdisMSetAttributesEx에서 제공된 정보에 의존하는 어떤 다른 NdisMRegisterXxx 혹은 NdisXxx 함수를 호출하기 전에 NdisMSetAttributesEx(혹은 NdisMSetAttributes)를 호출해야 한다. 예를 들어, NIC 드라이버으 NdisMAllocateMapRegisters에 대한 호출은 만약 MiniportInitialize가 AttributeFlags에 NDIS_ATTRIBUTE_BUS_MASTER 로 NdisMSetAttributesEx를 호출하지 않는다면은 실패할 것이다.

인터미디엇 드라이버들은 NdisMSetAttributes보다는 NdisMSetAttributesEx를 호출해야 한다. 그리고 AttributeFlags에 NDIS_ATTRIBUTE_INTERMEDIATE_DRIVER를 설정해야 한다. 이 플래그를 설정하는 것은 NDIS가 인터미이엇 드라이버에서 발생하는 드물지만은 일시적으로 멈추는 데드락들을 막아주는 풀-두풀렉스 미니포트로서 인터미디엇 드라이버를 다루게 한다. 결과적으로, 모든 인터미디엇 드라이버는 동시에 보내기들과 인디케이션들을 다룰 수 있게 해준다.

비직렬화된 드라이버들은 또한 NdisMSetAttributesEx를 호출해야 하고 AttributeFlags를 NDIS_ATTRIBUTE_DESERIALIZE로 설정해야 한다. NDIS는 비직렬화된 드라이버를 위해 보내기 패킷 큐를 유지하지 않는다. 혹은 그러한 드라이버의 MiniportXxx 함수들에 대한 호출들을 직렬화하지 않는다. 비직렬화된 드라이버는 그 자체로 다음과 같은 책임을 진다.:

• 모든 들어오는 보내기 요구들을 받아들인다.
• 만약 필요하다면은 내부적으로 들어오는 보내기 패킷들을 큐에 저장한다. 예를 들어, 만약 비직렬화된 NIC 드라이버는 현재 들어오는 보내기 패킷들이 즉시 전송하는데 이용할 수 있는 불충분한 자원들을 가질 때.
• 드라이버의 루틴들 사이에 필요한 내부 큐들에 대한 접근을 동기화한다.
• Miniport(Co)Send(Packets) 함수에 전달되어지는 각 프로토콜 제공 패킷 디스크립터로 NdisMSendComplete를 계속해서 호출함으로써 비동기적으로 모든 요구된 보내기들을 완성시킨다.

직렬화된 NIC 드라이버들이 MiniportInitialize로부터 이러한 함수들을 호출할 수 있지만은 NdisMSetAttributes는 NIC 드라이버의 MiniportCheckForHang 그리고/혹은 MiniportReset 함수들이 호출되지는 시간 간격을 조정하는 것을 호출자가 허락되지 않는다.

CheckForHangTimeInSeconds의 값은 NDIS 라이브러리의 초단위 타임아웃 간격을 결정한다. if any 호출자에게 큐로 저장되는 것을 유지하는 요구들을 결정한다. 디폴트로, NDIS가 큐에 저장된 보내기(직렬화된 드라이버를 위해서 단지)을 타임아웃되고 드라이버가 NdisMSetAttributesEx를 호출할 때 NDIS_ATTRIBUTE_IGNORE_PACKET_TIMEOUT 과 NDIS_ATTRIBUTE_IGNORE_REQUEST_TIMEOUT로 AttributeFlags로 설정되지 않는다면은 MiniportReset 함수를 호출한 후에 check-for-hang 시간 간격을 두 배로 요구한다. 인터미디엇 드라이버들은 그러한 드라이버는 아랫 NIC 드라이버가 보내기와 요구들을 처리할 때 결정할 수 없고 혹은 제어할 수 없기 때문에 NdisMSetAttributesEx를 호출할 때 이러한 플래그들을 설정해야 한다.

NIC 드라이버들은 비록 NDIS가 직렬화된 NIC 드라이버에 의해 그러한 사양을 지키지만은 NDIS_ATTRIBUTE_IGNORE_PACKET_TIMEOUT과 NDIS_ATTRIBUTE_IGNORE_REQUEST_TIMEOUT 플래그들을 설정하지 말아야 한다. 그러나 NIC 드라이버들은 그들의 MiniportReset 함수들은 CheckForHangTimeInSeconds를 지정함으로써 호출되어지는 time-out 간격을 조정할 수 있다. 예를 들어, 모뎀을 걸쳐 Ethernet을 모방하는 NIC 드라이버는 NDIS 라이브러리의 디폴트 타임아웃 간격내에 모든 패킷을 완성시키지 않을 것이다. 패킷이 그러한 NIC에서 타임아웃으로 나타날 때마다, NDIS가 NIC이 더 이상 올바르게 운영되지 않고 드라이버의 MiniportReset 함수를 호출하는 것을 추측할 것이다. 그러한 NIC 드라이버를 위해서 CheckForHangTimeInSeconds로 2보다 더 큰 어떤 값을 설정된 NdisMSetAttributesEx 함수를 호출하는 것은 불필요한 리셋을 막고 MiniportCheckForHang 함수가, if any, NIC의 연산 상태를 테스트하기 위해 호출되어지는 간격을 확장한다.

인터미디엇 드라이버는 NDIS_ATTRIBUTE_NO_HALT_ON_SUSPEND 플래그를 설정해야 한다. 이 플래그를 설정하는 것은 시스템이 낮은 전력(sleep)상태로 전이되기 전에 드라이버를 NDIS가 멈추게 하는 것을 막는다.

비 PnP 인식 NIC을 관리하는 legacy 미니포트는 낮은 전력 상태로 시스템 전이가 일어나기 전에 NDIS가 드라이버를 멈추게(halting) 하는 것을 막기 위해 NDIS_ATTRIBUTE_HALT_ON_SUSPEND 플래그로 설정할 수 있다. 만약 미니포트가 이 플래그를 설정한다면은, NDIS가 비록 미니포트 NIC을 위한 버스 드라이버가 NIC이 PM인식이 아니다라는 것을 인식시키지만은 NDIS는 미니포트에 OID_PNP_CAPABILITIES로 쿼리한다. 미니포트가 OID_PNP_CAPABILITIES 요구가 NDIS_STATUS_SUCCESS로 성공돼야 한다. 이 OID로 리턴된 NDIS_PM_WAKE_UP_CAPABILITIES 구조체내에서, 미니포트는 각 wake-up 능력을 위해서 NdisDeviceStateUnspecified의 장치 전원 상태를 또한 지정해야 한다. 낮은 전원 상태로의 시스템 전이할 때 미니포트는 그것이 유지한 어떤 하드웨어 컨텍스트을 저장해야 한다. D3 상태에서 OID_PNP_SET_POWER 요구를 수신하자마자, 미니포트는 NIC을 낮은 전원 상태를 위해 적당한 상태로 설정해야 한다. D0 상태로 OID_PNP_SET_POWER 요구를 수신하자마자, 미니포트는 NIC을 작동 상태을 위해 적당한 상태로 설정해야 한다.

일반적으로, NIC 드라이버는 NDIS는 그러한 호출이 일어나기 전에 AttributeFlags 값을 가져야하고 드라이버가 항상 이러한 호출에서 정보를 저장하기 위해 MiniportAdapterContext에 메모리를 필요로 하기 때문에 NIC을 위해 레지스트리에 하드웨어 자원들을 요구하는 어떤 NdisXxx 함수를 호출하기 전에 NdisMSetAttributesEx를 호출해야 한다. 이러한 제한은 NIC 드라이버의 MiniportInitialize 함수가 NdisMSetAttributesEx를 호출하기 전에 다음 NdisXxx를 호출할 수 없다는 것을 암시한다.

• NdisMPciAssignResources
• NdisMAllocateMapRegisters, NdisMAllocateSharedMemory
• NdisMMapIoSpace, Ndis...RegisterXxx 함수들
• NdisMRegisterDmaChannel
• NdisMRegisterInterrupt
• NdisMRegisterIoPortRange, NdisRaw..PortXxx 함수들

NdisMSetAttributesEx에게 제공된 MiniportAdapterContext 핸들이 NdisMRegisterMiniport 혹은 NdisIMRegisterLayeredMiniport에 대한 호출에서 MiniportInitialize와 함께 등록된 모든 MiniportXxx 함수들에 대한 입력 매개변수가 될 것이다. 항상 이 핸들은 드라이버가 NIC 특정 실행 상태를 유지하는 MiniportInitialize에 의해 할당된 상주 메모리에 대한 포인터이다.

NdisMSetAttributesEx는 IRQL PASSIVE_LEVEL에서 실행한다.