MB Data Model

The data model that is used by the MB driver model consists of a set of objects that are defined as abstractions of MB device features. Each object is identified by a unique object identifier (OID) and has a set of corresponding attributes defined for it. The set of attributes is organized into a data structure. To manage the device, the MB Service and the MB miniport driver exchange OIDs and their associated data structures based on OID requests and indications provided by NDIS.
MB 드라이버에서 사용하는 (MB 장치 기능 의 추상화된 정의들로 구성된) 객체 세트를 데이터 모델이라고 한다. 각가의 객체는 OID 로 구분되며, 적당한 속성값들을 가지고 있다. 속성값은 구조체로 정리되어 있다. 디바이스를 관리하기 위해서 MB 서비스와 MB 미니포트 드라이버는 OID및, 요청된OID 나 NDIS 의 indication과 관련된 데이터 구조체를 교환한다.

In the MB driver model, only set and query operations are used for OID requests. The MB driver model does not use method operations. For indications, the MB driver model uses both event notifications and transactional notifications to indicate state changes in the objects of the MB device. Transactional notifications also signal completion of an asynchronous transaction.

MB 드라이버 모델에서, OID 요청에 Set 과 Query만 사용된다. MB 드라이버 모델은 method 연산을 하지 않는다. MB 드라이버 모델은 MB 디바이스 객체의 상태 변화를 알려주기 위해 이벤트 notification과 transactional notification 두가지 방식을 모두 사용한다. transactional notification은 비동기 트랜젝션의 완료 신호이기도 하다.

The following tables list the OIDs and status indications defined for MB miniport drivers, as well as the associated data structures. MB miniport drivers must implement all mandatory general OIDs that the NDIS 6.20 Specification requires. For a list of general OIDs for NDIS 6.x, see NDIS 6.0 General OIDs for Miniport Drivers.

다음의 표에 보이는 OID와 상태 indication및 관련 데이터 구조체는 MB 미니포트 드라이버를 위해 선언되어 있다. MB 미니포트 드라이버는 반드시 NDIS 6.20 스펙에 명시된 OID를 모두 구현해야 한다. NDIS 6.x용 OID 리스트는 NDIS 6.0 General OIDs for Miniport Drivers 를 참고하라.

In addition, MB miniport drivers must implement OID_GEN_PHYSICAL_MEDIUM even though the NDIS Specification describes it as optional to implement.

추가로, MB 미니포트 드라이버는 (NDIS Specification 에서 옵션으로 설정한) OID_GEN_PHYSICAL_MEDIUM 을 반드시 구현해야 한다.

The syntax and semantics of the MB OIDs listed in the following table are described in MB Operational Semantics. The interactions between the MB Service and the MB miniport driver are described in MB Operation Flowcharts.

다음에 나온 MB OID들의 문법과 의미를 알고 싶다면 MB Operational Semantics 를 살펴보라. MB Service와 MB 미니포트 드라이버의 인터렉션 (상호작용) 는 MB Operation Flowcharts 를 통해 확인할 수 있다.

WWAN-specific OIDs

OID	Set operation	Query operation	Corresponding data structure	GSM / CDMA
OID_WWAN_DRIVER_CAPS	Not supported	S	NDIS_WWAN_DRIVER_CAPS	GSM, CDMA
OID_WWAN_DEVICE_CAPS	Not supported	A	None	GSM, CDMA
OID_WWAN_READY_INFO	Not supported	A	None	GSM, CDMA
OID_WWAN_SERVICE_ACTIVATION†	A	Not supported	NDIS_WWAN_SERVICE_ACTIVATION	GSM, CDMA
OID_WWAN_RADIO_STATE	A	A	NDIS_WWAN_SET_RADIO_STATE	GSM, CDMA
OID_WWAN_PIN	A	A	NDIS_WWAN_SET_PIN	GSM, CDMA
OID_WWAN_PIN_LIST	Not supported	A	None	GSM, CDMA
OID_WWAN_HOME_PROVIDER	Not supported	A	None	GSM, CDMA
OID_WWAN_PREFERRED_PROVIDERS†	A	A	NDIS_WWAN_SET_PREFERRED_PROVIDERS	GSM only
OID_WWAN_VISIBLE_PROVIDERS	Not supported	A	None	GSM only
OID_WWAN_REGISTER_STATE	A	A	NDIS_WWAN_SET_REGISTER_STATE	CDMA only
OID_WWAN_SIGNAL_STATE	A	A	NDIS_WWAN_SET_SIGNAL_INDICATION	GSM, CDMA
OID_WWAN_PACKET_SERVICE	A	A	NDIS_WWAN_SET_PACKET_SERVICE	GSM, CDMA
OID_WWAN_PROVISIONED_CONTEXTS††	A	A	NDIS_WWAN_SET_PROVISIONED_CONTEXT	GSM, CDMA
OID_WWAN_CONNECT	A	A	NDIS_WWAN_SET_CONTEXT_STATE	CDMA only
OID_WWAN_SMS_CONFIGURATION	A	A	NDIS_WWAN_SET_SMS_CONFIGURATION	GSM, CDMA
OID_WWAN_SMS_READ	Not supported	A	NDIS_WWAN_SMS_READ	GSM, CDMA
OID_WWAN_SMS_SEND	A	Not supported	NDIS_WWAN_SMS_SEND	GSM, CDMA
OID_WWAN_SMS_DELETE	A	Not supported	NDIS_WWAN_SMS_DELETE	GSM, CDMA
OID_WWAN_SMS_STATUS	Not supported	A	NDIS_WWAN_SMS_STATUS	GSM, CDMA
OID_WWAN_VENDOR_SPECIFIC†	A	Not supported	Vendor-defined	GSM, CDMA

Notes The following notes apply to the previous table:
노트. 다음의 참고 사항은 앞의 표에 있는 내용에 적용된다.

† represents optional OIDs that miniport drivers may support. Miniport drivers that do not support the optional OIDs must not return them in OID_GEN_SUPPORTED_LIST.

† 옵셔널 OID 이며 miniport 드라이버에서 지원 할 수 있다. 미니포트 드라이버에서 지원하지 않는 옵셔널 OID는 OID_GEN_SUPPORTED_LIST 에 포함해서 반환하면 안된다. 

†† represents miniport drivers that support GSM-based devices must support OID_WWAN_PROVISIONED_CONTEXTS set and query operations. Miniport drivers that support CDMA-based devices must support OID_WWAN_PROVISIONED_CONTEXTS query operations for CDMA-based devices that report Simple IP (WWAN_CTRL_CAPS_CDMA_SIMPLE_IP).

†† GSM 기반의 디바이스를 지원하는 미니포트 드라이버라면 OID_WWAN_PROVISIONED_CONTEXTS의 Set과 Query 동작을 지원해야 한다. CDMA 기반의 미니포트 드라이버는 Simple IP(WWAN_CTRL_CAPS_CDMA_SIMPLE_IP) 를 보고(report) 하는 디바이스를 위해 OID_WWAN_PROVISIONED_CONTEXTS 의 Query 동작을 지원해야 한다.

Miniport drivers must support all non-optional OIDs. The MB Service may ignore any miniport driver that does not report all of the mandatory OIDs.

미니포트 드라이버는 옵셔널 OID를 제외한 다른 OID를 반드시 지원해야 한다. MB 서비스는 의무적인 OID를 하나라도 보고(report)하지 못하는 미니포트 드라이버는 무시해 버릴 것이다.

"A" and "S" in the Set and Query Operation columns in the previous table reflect the nature of the transaction for completing the OID request: "A" standards for an asynchronous transaction and "S" for a synchronous transaction.
표의 Set과 Qeury 동작 컬럼에 보이는 "A" 와 "S" 는 OID 요청에 대한 트랜잭션 종류를 나타낸다. "A"는 일반적인 비동기 트랜잭션 동작을 의미하며, "S"는 동기적인 트랜잭션을 의미한다.

The data structures in preceding table correspond to set operation OIDs and to return data for synchronous query OIDs.

앞의 테이블에 보이는 Set과 Query 에 사용한 데이터 구조체는 동일한 구조체로 사용하여야 한다.

The following OIDs share a common, variable length list data structure called WWAN_LIST_HEADER in their corresponding data structures:
다음의 OID들은 WWAN_LIST_HEADER 이라는 공통의 구조체 변수를 자신의 구조체 안에 포함하고 있다.

OID_WWAN_READY_INFO
OID_WWAN_PREFERRED_PROVIDERS
OID_WWAN_VISIBLE_PROVIDERS
OID_WWAN_PROVISIONED_CONTEXTS
OID_WWAN_SMS_READ

WWAN-specific indications

Indication	Corresponding data structure	GSM	CDMA	Unsolicited indication allowed
NDIS_STATUS_WWAN_DEVICE_CAPS	NDIS_WWAN_DEVICE_CAPS	X	X	N
NDIS_STATUS_WWAN_READY_INFO	NDIS_WWAN_READY_INFO	X	X	Y
NDIS_STATUS_WWAN_RADIO_STATE	NDIS_WWAN_RADIO_STATE	X	X	Y
NDIS_STATUS_WWAN_PIN_INFO	NDIS_WWAN_PIN_INFO	X	X	N
NDIS_STATUS_WWAN_PIN_LIST	NDIS_WWAN_PIN_LIST	X	X	N
NDIS_STATUS_WWAN_SERVICE_ACTIVATION†	NDIS_WWAN_SERVICE_ACTIVATION_STATUS	X	X	N
NDIS_STATUS_WWAN_HOME_PROVIDER	NDIS_WWAN_HOME_PROVIDER	X	X	N
NDIS_STATUS_WWAN_PREFERRED_PROVIDERS†	NDIS_WWAN_PREFERRED_PROVIDERS	X		Y
NDIS_STATUS_WWAN_VISIBLE_PROVIDERS	NDIS_WWAN_VISIBLE_PROVIDERS	X	X	N
NDIS_STATUS_WWAN_REGISTER_STATE	NDIS_WWAN_REGISTRATION_STATE	X	X	Y
NDIS_STATUS_WWAN_SIGNAL_STATE	NDIS_WWAN_SIGNAL_STATE	X	X	Y
NDIS_STATUS_WWAN_PACKET_SERVICE	NDIS_WWAN_PACKET_SERVICE_STATE	X	X	Y
NDIS_STATUS_WWAN_PROVISIONED_CONTEXTS	NDIS_WWAN_PROVISIONED_CONTEXTS	X	X	Y
NDIS_STATUS_WWAN_CONTEXT_STATE	NDIS_WWAN_CONTEXT_STATE	X	X	Y
NDIS_STATUS_WWAN_SMS_CONFIGURATION	NDIS_WWAN_SMS_CONFIGURATION	X	X	Y
NDIS_STATUS_WWAN_SMS_RECEIVE	NDIS_WWAN_SMS_RECEIVE	X	X	Y
NDIS_STATUS_WWAN_SMS_SEND	NDIS_WWAN_SMS_SEND_STATUS	X	X	N
NDIS_STATUS_WWAN_SMS_DELETE	NDIS_WWAN_SMS_DELETE_STATUS	X	X	N
NDIS_STATUS_WWAN_SMS_STATUS	NDIS_WWAN_SMS_STATUS	X	X	Y
NDIS_STATUS_WWAN_VENDOR_SPECIFIC†	Vendor-defined	X	X	Y

Notes The following notes apply to the previous table:
노트. 다음의 참고 사항은 앞의 표에 있는 내용에 적용된다.

† represents optional indications that miniport drivers may support. Be aware that if a miniport driver supports an optional OID, the miniport driver should also support the corresponding indication.

† 옵셔널 OID 이며 miniport 드라이버에서 지원 할 수 있다. 만약 미니포트 드라이버가 옵셔널 OID를 지원한다면, 그에 맞는 Indiciation도 지원해야 한다.