Chapter 1 NDIS 객체 식별자

이것은 NDIS 객체 식별자들을 설명한다. NDIS 객체 식별자들은 상위 레벨 NDIS 드라이버들이 NdisRequest 나 NdisCoRequest에 대한 그들의 호출에 대해서 NDIS_REQUEST 타입 구조체에서 셋한 OID_XXX의 시스템 정의된 상수들이다. 각각의 그런 요구는 다음의 하나로서 분류된다.

• 질이는 밑의 NDIS 드라이버에 대해서나 밑의 NDIS 드라이버로부터 정보를 가져오기위한 호출이다. 일반적으로 드라이버나 NIC의 전반적인 능력들이나 현재 상태에 대한 것이다.

  NDIS 프로토콜 드라이버는 전체적인 질의들을 만들 때 NdisRequest 나 NdisCoRequest에서 RequestType 인자에 대해서 NdisRequestQueryInformation를 셋한다. NdisRequest로 만들어진 그런 요구는 밑의 NIC 드라이버의 MiniportQueryInformation 함수에의해서 다루어진다. NdisCoRequest로 만들어진 그런 요구는 밑의 연결 지향 NIC 드라이버의 MiniportCoRequest 함수나 요구의 목적에 의존하는 연결 지향 클라이언트, 호출 관리자, MCM 미니포트의 ProtocolCoRequest 함수에의해서 다루어진다.

• 통계 질의는 네트워크 성능에 대한 정보를 가져오기위한 호출이다. 그런 요구는 사용자 모드 응용프로그램에서 항상 발생한다. 프로토콜 드라이버들은 NdisRequest 나 NdisCoRequest에서 RequestType 인자에 대해서 NdisRequestQueryStatistics을 셋하지 않는다. NdisRequest로 만들어진 그런 요구는 밑의 NIC 드라이버의 NDIS나 MiniportQueryInformation 함수에의해서 다루어진다. NdisCoRequest 로 만들어진 그런 요구는 밑의 연결 지향 NIC 드라이버의 NDIS 나 MiniportCoRequest 함수에의해서 다루어진다.
• 셋은 밑의 드라이버가 선택을 제공할 때나 미티포트가 NIC에게 인에이블해야하는 추가적인 특성에 대한 수신 지시에 사용되는 것을 프로토콜이 원하는 헤더 포맷 같은 밑의 NDIS 드라이버에 대한 방향들과 함께하는 호출이다. NDIS 프로토콜 드라이버는 그것이 요구의 타입을 만들 때, NdisRequest 나 NdisCoRequest에서 RequestType 인자에 대해서 disRequestSetInformation을 셋한다. NdisRequest로 만들어진 그런 요구는 밑의 NIC 드라이버의 MiniportSetInformation 함수에의해서 다루어진다. NdisCoRequest 로 만들어진 그런 요구는 밑의 연결 지향 NIC 드라이버의 MiniportCoRequest 함수나 요구의 목적지에 의존하는 연결지향 클라이언트, 호출 관리자 또는 ,MCM 미니포트의 ProtocolCoRequest 함수에의해서 다루어진다.

많은 시스템 정의된 OID들은 하나 이상의 선행하는 NdisRequestXxx 값들에 유효하다. OID_XXX에의해서 식별되는 각각의 NDIS 객체에 관계된 것은 데이터 버퍼이다. 데이터 버퍼는 주어진 OID에 의존해서 크기와 포맷이 다양하다. NdisRequest의 호출자는 NDIS_REQUEST 구조체의 InformationBuffer 호출자에서 데이터 버퍼에대한 포인터를 제공한다.

OID들은 실재 일반적이거나 미디어-스펙이다. OID에 정의된 각각은 추가적인 OID이거나 통계 OID이다. 각각의 NDIS 정의된 OID에 대한 지원은 강제적이거나 추가적이다.

OID들에 대한 정보의 어떤 것은 차트안에 존재한다. 각각의 엔트리에 대해서, 이 차트들은 테이블 1.1 에 요약된 정보를 포함한다.

Table 1.1 Key to OID Charts

Column Header	Notation Meaning
Length	기본적으로 값은 OID에 관계된 데이터의 바이트 수를 리턴한다. NIC 드라이버는 카운터들을 리셋할 수 없다.; 카운터들이 최고에 도달했을 때 카운터들은 랩한다. 폼 Arr(n)에 설명된 값들은 각각의 크기 n인 엘리먼트들의 배열을 지시한다. 밑의 드라이버는 배열 엘리먼트들을 연속적으로 패딩없이 저장한다.
Q	An "M"은 OID가 NdisRequest에 대한 호출에서나 RequestType 값이 NdisRequestQueryInformation로 NdisCoRequest에 대한 호출에서나 프로토콜들 NdisRequestQueryStatistics보다 다른 컴포넌트들로부터 유효하다는 것을 지시한다. "O" 은 추가적인 OID가 만약 밑의 NDIS 드라이버가 OID를 지원한다며 요구의 같은 타입에서 유효하다는 것을 지시한다.
S	An "M" 은 OID가 NdisRequest에 대한 호출에서나 RequestType 값이 NdisRequestQueryInformation로 NdisCoRequest에 대한 호출에서 유효하다는 것을 지시한다. "O" 은 추가적인 OID가 만약 밑의 NDIS 드라이버가 OID를 지원한다며 요구의 같은 타입에서 유효하다는 것을 지시한다.
Name	상수 이름의 간단한 설명에의해서 따르는 시스템 정의된 OID_XXX.

NDIS 정의된 OID_XXX 상수들은 4바이트 값이고 다음의 차트에서 보여지는같이 인코드된다. 그러나, 형식 OID_TAPI_XXX의 OID들은 각각의 OID의 지원이 의무적인지 추가적인지를 지시하는 값을 가지지 않는다.

Byte (LSB to MSB)	Code(s)	Definition
1	0xN (unique value)	상위 순서 바이트들에서 같은 값으로 다른 것들로부터 각각의 OID를 구분한다.
2	0x01	의무적
	0x02	추가적
3	0x01	연산적인 특성들
	0x02	통계
4	0x00	일반적인 정보
	0x01-0xFE	다음과 같은 시스템 정의된 미디어 스펙 정보:
	0x01	Ethernet (802.3)
	0x02	Token Ring (802.5)
	0x03	Fiber Distributed Data Interface (FDDI)
	0x05	LocalTalk
	0x06	ARCNET
	0x04	Wide area network (WAN)
	0x07	TAPI
	0x08	Native ATM
	0x09	Wireless
	0x0A	Reserved for infrared (IrDA)
	0xFE	연결 지향 미디어에 대한 호출 관리자들
	0xFF	벤더 스펙 정보

OID 스펙 레퍼런스들에 대해서 다음의 챕터들을 보아라.

Chapter 2 - General Objects for OIDs supported by all drivers

Chapter 3 - Ethernet Objects

Chapter 4 - Token Ring Objects

Chapter 5 - FDDI Objects

Chapter 6 - LocalTalk Objects

Chapter 7 - ARCNET Objects

Chapter 8 - WAN Objects

Chapter 9 - TAPI Objects

Chapter 10 - Wireless Objects

Chapter 11 - Connection-Oriented Objects