10.1 Wireless Operational Characteristics

다음 차트는 무선 WAN미니포트 드라이버 와/혹은 그들의 닉들에대한 일반적인 연산적 특징들을 설정하거나 얻어오기위해 사용된 OID들을 요약한다.

Q S Indication Name
M     OID_WW_GEN_NETWORK_TYPES_SUPPORTED
M M M OID_WW_GEN_NETWORK_TYPE_IN_USE
M     OID_WW_GEN_HEADER_FORMATS_SUPPORTED
M M M OID_WW_GEN_HEADER_FORMAT_IN_USE
  M   OID_WW_GEN_INDICATION_REQUEST
M   OID_WW_GEN_DEVICE_INFO
M M M OID_WW_GEN_OPERATION_MODE
M   M OID_WW_GEN_LOCK_STATUS
M M M OID_WW_GEN_DISABLE_TRANSMITTER
M M M OID_WW_GEN_NETWORK_ID
M     OID_WW_GEN_PERMANENT_ADDRESS
M M M OID_WW_GEN_CURRENT_ADDRESS
M M M OID_WW_GEN_SUSPEND_DRIVER
M   M OID_WW_GEN_BASESTATION_ID
M M OID_WW_GEN_CHANNEL_ID
M   OID_WW_GEN_ENCRYPTION_SUPPORTED
M M M OID_WW_GEN_ENCRYPTION_IN_USE
M M M OID_WW_GEN_ENCRYPTION_STATE
M   M OID_WW_GEN_CHANNEL_QUALITY
M M OID_WW_GEN_REGISTRATION_STATUS
M   OID_WW_GEN_RADIO_LINK_SPEED
M OID_WW_GEN_LATENCY
M M OID_WW_GEN_BATTERY_LEVEL
M M OID_WW_GEN_EXTERNAL_POWER
O O   OID_WW_GEN_PING_ADDRESS
O   OID_WW_GEN_RSSI
O OID_WW_GEN_SIM_STATUS
  O OID_WW_GEN_ENABLE_SIM_PIN
O OID_WW_GEN_CHANGE_SIM_PIN
O OID_WW_GEN_SIM_PUK
O   O OID_WW_GEN_SIM_EXCEPTION

다음은 각 선행하는 OID들을 설명하고 연관된 구조체들을 좀더 자세히 각각 설명한다.

네트웍 타입 의존 OID_WW_XXX의 설정에대한 레퍼런스들은 OID_WW_GEN_XXX로 나타낸다.

만약 그렇게 지정되지 않는다면, 요청하는 프로토콜은 OID요청을 완료하기위해 모든 버퍼 공간을 할당하고 구조체와 포인터들을 초기화 해야한다. 하위 NDIS드라이버들은 제공된 버퍼들로 데이타를 복사하기만 한다.

하드웨어 구조들과 구조체화에서의 차이에대해 언급하기위해, 구조체 멤버들은 8바이트(NDIS정의 NDIS_PHYSICAL_ADDRESS타입)영역으로 정렬하고 "C"(혹은 유사한(analogous)기능)에서의 크기(sizeof) 연산는 구조체 요소들의 길이를 계산하기위해 사용되어져야만 한다.

몇몇 네트웍 장치들은 장치를 구성하기위해 외부 인터페이스들을 지원한다. 그러므로, 동적으로 변화하는것은 몇몇 오브젝트들에대한 가능하고, 이것은 하위 미니포트 드라이버의 컨추럴범위 밖의 것이다.

NDIS_VAR_DATA_DESC

이러한 많은OID들은 다음과 같은 NDIS_VAR_DATA_DESC구조체의 멤버를 가진 구조체와 연관이 있다.: 


typedef struct  _NDIS_VAR_DATA_DESC {

    USHORT  Length;  // number of bytes of data in buffer

    USHORT  MaximumLength; // total size of buffer in bytes 

    LONG    Offset;  // offset in bytes, relative to struct

} NDIS_VAR_DATA_DESC, *PNDIS_VAR_DATA_DESC;

이 구조체는 NDIS_VAR_DATA_DESC구조체의 베이스 가상 주소와 관계된 버퍼 공간을 설명하기위해 사용된 타입을 정의한다. 다시말하면, 버퍼의 포인터는 이 타입에의해 명확하게 제공되지 않는다.; 버퍼 공간에대한 옵셋만이 제공된다. 이 디스크립터가 실제 포인터로 사용되지않기때문에, 사용자 모드 어플리케이션은 이 타입의 디스크립터를 가지고 버퍼를 할당할수 있고 디스크립터의 베이스 가상 주소와 관계된 이 버퍼의 옵셋을 제공한다. 이것은 유저모드와 커널모드사이의 주소 멥핑없이 이러한 디스크립터들을 포함하는 구조체들을 허용한다. 그 버퍼와 NDIS_VAR_DATA_DESC구조체는 연속적일수 있고 연속적이지 않을수 있다. 왜냐하면 지정한 옵셋은 프로토콜 혹은 어플리케이션이 어떤곳에나 할당할 수 있는 저장장소의 포인터 일수 있기 때문이다. 0과 sizeof(NDIS_VAR_DATA_DESC)사이의 지정한 옵셋은 무효하다.

NDIS_VAR_DATA_DESC타입의 정보를 리턴하는 질의들은 0종료 버퍼들(즉, 이 구조체의 Offset멤버를 NULL로 설정한다.)이어야하고 만약 요청된 정보가 이용할수 없다면 버퍼 사이즈로써 0을 리턴해야한다. 예를들어, 만약 장치에서의 소프트웨어/펌웨어의 개정 넘버가 알려지지 않았다면, 무선 WAN미니포트 드라이버는 OID_WW_GEN_DEVICE_INFO질의에대한 SWVersionNum에 Offset에대해 NULL을 그리고 Length에대해 0을 리턴해야만 한다.

각OID_WW_GEN_XXX의 정의는 하위 미니포트 드라이버에게로 넘겨지는 NDIS_REQUEST구조체내의 InformationBuffer에서의 데이타 타입의 설명으로 다음과 같다.

OID_WW_GEN_NETWORK_TYPES_SUPPORTED

이 OID들에대해 미니포트 드라이버는 다음의 시스템 정의 값의 어떤 적절한 부분을 가지고 있는 드라이버와 닉에의해 지원되는 타입의 배열을 리턴한다.: :

NdisWWGeneric
NdisWWMobitex
NdisWWPinpoint
NdisWWCDPD
NdisWWArdis
NdisWWDataTAC
NdisWWMetricom
NdisWWGSM
NdisWWCDMA
NdisWWTDMA
NdisWWAMPS
NdisWWInmarsat
NdisWWpACT
NdisWWFlex
NdisWWIDEN

선행하는 리스트로부터의 특정한 타입을 갖는 완전한 협력을 주장할수 없는 어떠한 미니포트 드라이버라도 이 질의에대해 NdisWWGeneric을 리턴한다. 그렇지 않으면, 미니포트 드라이버는 완전히 따르는 지원을 제공할수 있다는것에대한 특정한 타입의 리스트를 리턴해야한다.

NdisWWArdis타입은 NdisWWDataTAC타입하에서 포함되어진다는것을 기억하라. 즉, 만약 미니포트 드라이버와 닉이 NdisWWDataTAC타입을 지원한다면, 그들은 또한 NdisWWArdis타입을 지원한다.

설정과 인디케이트는 이 OID에대해 적절하지 않다.

OID_WW_GEN_NETWORK_TYPE_IN_USE

질으로써, 이 OID는 하위 미니포트 드라이버와 닉이 미니포트와 닉에의해 현재 사용되고 있는 NDIS_WW_NETWORK_TYPE을 리턴하도록 요청한다. 가능한 값들에대해서는 OID_WW_GEN_NETWORK_TYPES_SUPPORTED를 보라.

설정으로써, 이 OID는 하위 미니포트 드라이버와 닉이 닉과 스스로를 지정된 NDIS_WW_NETWORK_TYPE값을 사용하도록 설정하기를 요청한다. 만약 미니포트 드라이버가 단지 하나의 네트웍 타입을 지원한다면, 이타입을 네트웍 디폴트로 설정해서 바인딩된 프로토콜은 그러한 미니포트 드라이버에게 이 OID를 설정하지 못한다.

NdisWWGeneric은 질의에대한 응답으로 어떤 열거된 네트웍 타입으로 완전히 따르도록 요구하지 못하는 하위 드라이버들에대한 요청들의 설정에서 지정되어져야만 한다.

만약 하위 미니포트 드라이버가 하나의 네트웍 타입이상 지원할 수 없다면, 바인딩된 프로토콜은 이 OID요청을 NdisOpenAdapter함수의 성공적인 호출에 즉시 뒤따르고OID_WW_GEN_HEADER_FORMAT_IN_USE으로 NdisRequest함수를 호출하기 이전에 네트웍 타입을 설정하기위해 만들어야한다.

미니포트 드라이버가 이 OID에의해 요청된 설정 연산을 완료한후, 네트웍 타입은 모든 바인딩된 프로토콜들에대해 설정한다.

만약 어떤 바인딩된 프로토콜이 OID_WW_GEN_INDICATION_REQUEST로 인디케이트 할수 있다면, 미니포트 드라이버는 만약 네트웍 타입이 변하면 그런 프로토콜들에게 알리기위해 NdisMIndicateStatus함수를 호출해야만 한다. 그것은 OID_WW_GEN_INDICATION_REQUEST내에 지정된 TriggerValue멤버를 무시 할수 있다.

OID_WW_GEN_HEADER_FORMATS_SUPPORTED

이 OID에대해, 미니포트 드라이버는 미니포트 드라이버가 하나혹은 그이상의 다음 시스템 정의 값들을 지원 할 수 있는 헤더 포멧의 배열을 리턴한다. :

NdisWWDIXEthernetFrames
NdisWWMPAKFrames
NdisWWRDLAPFrames
NdisWWMDC4800Frames
NdisWWNCLFrames

DIX 이더넷은 디폴트 헤더 포맷이다. 모든 무선 WAN미니포트 드라이버는 이 포맷을 지원해야만 한다. 어떤 미니포트 드라이버는 추가적인 포맷들을 지원할수 있다. 그러나, 미니포트 드라이버는 적어도 하나이상의 닉이 원래 가지고 있는 포맷이외의것을 지원 하수 있다.

NdisWWRDLAPFrames와 NdisWWMDC4800Frames타입은 NdisWWNCLFrames타입하에 포함된다. 즉, 만약 미니포트 드라이버와 닉이 NdisWWRDLAPFrames와 NdisWWMDC4800Frames타입을 지원한다면, 그들은 또한 NdisWWNCLFrames타입을 지원한다.

설정과 인디케이트는 이 OID에대해 적절치 않다.

OID_WW_GEN_HEADER_FORMAT_IN_USE

질의에대해, 이 OID는 하위 미니포트 드라이버와 닉 현재 사용하고 있는 NDIS_WW_HEADER_FORMAT을 리턴하도록 요청한다. 가능한 값에대해서는 OID_WW_GEN_HEADER_FORMATS_SUPPORTED를 보라.

설정으로써, 이 OID는 하위 미니포트 드라이버와 닉이 이전에 OID_WW_GEN_HEADER_FORMATS_SUPPORTED에대한 응답으로 리턴한 특정한 헤더 포맷을 사용하도록 요청한다. 만약 바인딩된 프로토콜이 설정을 요청하지 않는다면, 미니포트 드라이버는 디폴트로 DIX-Ethernet 프래이밍을 사용한다.

만약 하위 미니포트 드라이버가 하나의 헤더 타입이상을 지원할수 있다면, 바인딩된 프로토콜은 이 OID요청을 OID_WW_GEN_NETWORK_TYPE_IN_USE으로 NdisRequest함수의 성공적인 호출을 즉시 뒤따라 만들어야한다.

만약 어떤 바인딩된 프로토콜이 OID_WW_GEN_INDICATION_REQUEST로 인디케이트를 할수 있다면, 헤더 포맷이 변하면, 미니포트 드라이버는 그런 프로토콜에게 알리기위한 NdisMIndicateStatus를 호출해야만 한다. 그것은 OID_WW_GEN_INDICATION_REQUEST로 지정된 TriggerValue멤버를 무시 할수 있다.

OID_WW_GEN_INDICATION_REQUEST

이 OID는 하위 미니포트 드라이버에게 이벤트 큐에대한 지정된 인디케이트 요청을 위치하라고 알린다.

이 OID는 바인딩된 프로토콜들에게 그들을 특정한 무선 OID들과 관계된 변화를 알려지도록 한다. 그런 프로토콜은 아래와 같이 정의된 NDIS_WW_INDICATION_REQUEST구조체를 몇몇 OID코드들에대한 OID_WW_XXX코드를 지정하고 트리거(triger)값을 지정하는 NdisRequest함수에게 넘긴다. Oid멤버내에 지정된 OID_WW_XXX에대한 정의내에 진술된것이 없는한, 그런 OID_WW_GEN_INDICATION_REQUEST로부터 리턴하자마자, 지정된 OID코드의 현재 값은 InitialValue값에 있게될것이다.

왜냐하면, 미니포트 드라이버는 모든 바인딩된 프로토콜에대한 OID와 관계된 상태를 인디케이트 하기위해 NdisMIndicateStatus함수를 호출하기때문에, 이 미니포트 드라이버는 요청에대해 NDIS_WW_INDICATION_REQUEST구조체의 카피본을 유지해야만 한다. 이 미니포트 드라이버는 이 구조체를 NdisMIndicateStatus함수가 리턴한후에 해제할수 있다. 미니포트 드라이버는 다음과 같은 이유로 이 구조체의 카피본을 유지한다. 프로토콜이 프로토콜이 등록했던것에대한 OID과 관계된 이벤트의 알림을 받은후, 프로토콜은 자기자신의 인디케이트-요청 구조체를 해제한다. 미니포트 드라이버가 이 구조체의 카피본을 가지고 있기때문에, 그 카피본은 타당하게 남아있다. 그러므로, 다른 바인딩된 프로토콜들은 또한 그 OID와 관계된 유효한 상태를 받는다.

NDIS_WW_INDICATION_REQUEST구조체는 다음과 같이 정의 된다.: 


typedef struct _NDIS_WW_INDICATION_REQUEST {

    NDIS_OID           Oid;               // IN 

    UINT               uIndicationFlag;    // IN 

    UINT               uApplicationToken;  // IN  

    HANDLE             hIndicationHandle; // IN OUT 

    INT                iPollingInterval;  // IN OUT 

    NDIS_VAR_DATA_DESC InitialValue;      // IN OUT 

    NDIS_VAR_DATA_DESC OIDIndicationValue; // OUT 

    NDIS_VAR_DATA_DESC TriggerValue;        // IN

} NDIS_WW_INDICATION_REQUEST;

이 구조체의 멤버는 다음 정보를 포함한다.:

Oid
미니포트 드라이버가 이벤트를 인디케이트해야하는 것에대한 OID_WW_XXX코드.

프로토콜은 이 멤버를 설정한다.

uIndicationFlag
다음 플레그들중 하나가 설정될수 있는 비트마스크를 지정한다.:

OID_INDICATION_REQUEST_ENABLE
미니포트 드라이버는 만약 이구조체내에 지정된 이벤트가 발생한다면 NdisMIndicateStatus함수를 호출해야한다.

OID_INDICATION_REQUEST_CANCEL
미니포트 드라이버는 지정된 이벤트에대한 알림을 취소해야한다. Oid내에 지정된 값과 hIndicationHandle멤버들은 지연(preceding)하는 OID_WW_GEN_INDICATION_REQUEST내에 지정된 값과 메치되어야 한다.

uIndicationFlag안에 잇는 모든 다른 비트들은 미래사용을 위해 예약된다.

프로토콜은 이 멤버를 설정한다.

uApplicationToken
미니포트 드라이버가 지정된 이벤트를 포스트(post)할때, 미니포트 드라이버에의해 리턴된 어플리케이션 정의(혹은 프로토콜 정의)토큰을 지정한다. 미니포트 드라이버는 이 멤버를 드라이버의 내부적인 이벤트 큐에 이벤트를 놓기전에 인디케이션 요청 연산동안에 카피해야만 한다. 미니포트 드라이버는 그리고 요청하고있는 프로토콜이 짖정된 인디케이션 이벤트가 정확하게 디멀티플렉스(*하나의 선택에서 여러개의 선택중 하나에 실어주는 제어*)할 수 있다.

프로토콜은 이 멤버를 설정한다.

hIndicationHandle
미니포트의존 핸들을 지정한다. 프로토콜 혹은 어플리케이션은 이 핸들을 저장할 것이고 그것을 차후에 이 요청을 취소하는데 사용할수 있다(uIndicationFlag를 보라). 미니포트 드라이버는 이 멤버를 드라이버의 내부적인 이벤트 큐에 이벤트를 위치하기전에 인디케이션-요청 연산동안에 이 멤버를 초기화 해야만 한다. 미니포트 드라이버는 요청하는 프로토콜이 현재 지정된 인디케이션 이벤트를 정확하게 디멀티플렉스 할수 있다는것을 보장한다. 이 멤버는 미니포트 드라이버에의해 리턴되거나 혹은 프로토콜에의해 취소가 설정된다.

iPollingInterval
미니포트 드라이버가 무선 닉에게 주어진 OID값을 모니터하기위해 폴링해야하는 밀리초단위의 인터벌을 지정한다.

만약 이 멤버가 -1로 설정된다면, 미니포트 드라이버는 장치를 폴링하기위해 자신의 디폴 설정을 사용해야한다. 리턴하기전에, 미니포트 드라이버는 이 멤버를 실제 폴링 인터벌을 밀리초단위로 설정해야만 하고, 이 인디케이션을 위해 사용할 것이다. 이것은 프로토콜 혹은 어플리케이션으로 허여금 미니포트 드라이버가 OID 너무 자주 셈플링하는지를 결정도록 허용한다. 프로토콜 혹은 어플리케이션은 처음 요청을 취소할 가능성이 있을수 있고 더많은 적절한 인터벌로 닉에게 폴링하기위해 미니포트 드라이버에게 요청하는 또다른 요청을 만들가능성이 있다. 리턴된 값은 프로토콜 혹은 어플리케이션이 설정한 값보다 크거나 작을수 있다.

미니포트 드라이버는 이 멤버를 취소 연산동안 무시한다.

이 멤버는 프로토콜에의해 설정되고 미니포트 드라이버에의해 리턴된다.

InitialValue
입력으로, 예를들어, OID_WW_GEN_CURRENT_ADDRESS의 경우처럼 요청된 알림을 초기화하기위해 필요한 정보를 포함할수 있는 NDIS_VAR_DATA_DESC-타입의 버퍼. 미니포트 드라이버는 리턴하기전에 이 버퍼내에 지정된 OID의 현재 값에대한 정보를 설정한다. 이 같은 값은 또한 실제 인디케이트 이벤트가 트리거된후 NdisMIndicateStatus함수의 호출을 통하여 미니포트 드라이버에의해 리턴된다.

미니포트 드라이버는 취소 연산동안에 이 멤버를 무시한다.

이 멤버는 프로토콜에의해 설정되고 미니포트 드라이버에의해 리턴된다.

OIDIndicationValue
입력으로, 초기화된 NDIS_VAR_DATA_DESC-타입의 버퍼를 포함한다. 프로토콜은 적어도 인디케이션 요청동안에 OIDIndicationValue의 MaximumLength멤버를 초기화 해야만한다. 그래서 미니포트 드라이버는 그 응답이 프로토콜의 버퍼내에 적합한지를 결정할수 있다. 미니포트 드라이버가 이벤트 알림을 만들기전에, 지정된 OID의 값을 포함하기위해 NDIS_VAR_DATA_DESC-타입 버퍼를 할당하고 NDIS_WW_INDICATION_REQUEST구조체의 카피본을 체운다.

프로토콜은 미니포트 할당 버퍼를 단지 이벤트의 상태 인디케이션동안에만 참조할 수 있다. 할당한 드라이버는 이버퍼를 할당해제할수 있고 이 이벤트로 NdisMIndicateStatus함수를 호출하는것으로부터 리턴된 이벤트를 트리거하기위해 필요한 모든 리소스들을 해제 할수 있다.

미니포트 드라이버는 이 멤버를 취소 연산동안에 무시한다.

OIDIndicationValue의 MaximumLength멤버만이 요청 시간에 미니포트 드라이버에의해 입증된다. OIDIndicationValue의 다른 멤버는 미니포트 드라이버에의해 할당되고 단지 이벤트 알림동안에만 유효하다.

TriggerValue
입력으로, 하위 미니포트 드라이버가 지정된 이벤트를 인디케이트 할때를 결정하기위해 사용할지 모르는 값을 포함하는 NDIS_VAR_DATA_DESC-타입을 지정한다. 이 멤버의 값은 프로토콜이 알림을 요청하는것에대한 특정한 OID코드에 의존하여 NULL일수 있다. 만약 이 멤버의 값이 NULL이면, 미니포트 드라이버는 그것을 무시할 수 있다. 예르들어, 미니포트 드라이버는 상태에 변화에있어 트리거하는 OID코드에대해 이 멤버를 무시할수 있다. 더많은 정보에대해서는 각각의 OID_WW_XXX코드의 설명을 보아라. 미니포트 드라이버는 취소 연산동안에 이 멤버를 무시한다.

미니포트 드라이버는 InitialValue와 iPollingInterval멤버내에 체워야만 한다. 주어진 구조체의 프로토콜과 미니포트의 카피본내에 미니포트 드라이버의 현재 정보의 상태로 체운다. 요청된 OID가 트리거 값에 다다른후 혹은 상태가 OID변화에 부합된후, 미니포트 드라이버는 이 구조체의 카피본내에 OIDIndicationValue멤버내에 체운다. 이 요청을 초기화하는 프로토콜은 소유권이 프로토콜에게로 리턴되기까지 할당한 NDIS_WW_INDICATION_REQUEST구조체내의 어떤것에도 접근할수 없다. 프로토콜은 NdisRequest함수가 NDIS_STATUS_PENDING을 리턴하지 않은 그 상태를 입증하는것에의해 이 구조체를 다시 소유할것인지를 쉽게 결정할수 있다. 또한, OID_WW_GEN_INDICATION_REQUEST로부터 리턴된 상태가 미니포트 드라이버에의해 성공적인 큐화되는것과 취소되는것만은 인디케이트 하고 실제 이벤트 실행을 나타내지 않는다.

특정한 OID에대한 이벤트 알림이 이 요청에의해 인에이블 된후, 무선 WAN미니포트 드라이버는 적절한 정보를 체우고 그런 알림을 다음 가이드 라인에 따라 모든 바인딩된 프로토콜들에게 포워드하는 NDIS에게 알리기위해 NDIS_STATUS_WW_INDICATION로 NdisMIndicateStatus함수를 호출할 수 있다.:

  • TriggerValue를 사용하는 OID_WW_GEN_XXX코드에대해:
    • InitialValue < TriggerValue일때, 미니포트 드라이버가 지정된 상태에대해 모니터하기위해 유지한다. OID에대한 현재의 값이 주어진 TriggerValue보다 크거나 같을때 그런 이벤트를 위치한다.
    • 만약 InitialValue = TriggerValue이면, 미니포트 드라이버는 주어진 구조체내에 남아있는 정보를 체우고 이벤트를 즉시 위치시키기위해 NdisMIndicateStatus함수를 호출한다.
    • 만약 InitialValue > TriggerValue이면, 미니포트 드라이버는 OID에대한 현재 값이 TriggerValue보다 작거나 같을때 이벤트를 위치해야 한다.
    • 만약 InitialValue가 알려지지 않는다면, 이벤트는 OID의 현재 값이 알려지지 않은 값 이외의 값으로 변화한후 위치된다.
  • TriggerValue를 상요하지 않는 OID_WW_XXX코드에대해:

    미니포트 드라이버는 상태변화가 변화할때 그 OID_WW_XXX에대해 설정된것처럼 이벤트를 위치해야만 한다.

요청된 이벤트가 위치된 후, 프로토콜의 호출은 또다른 NDIS_STATUS_WW_INDICATION이벤트를 받기위해 다른 인디케이트 요청을 제안해야만 한다. NdisRequest함수의 비동기적인 호출때문에, 프로토콜 개발자는 요청된 이벤트가 OID_WW_GEN_INDICATION_REQUEST로 NdisRequest함수에대한 호출을 리턴하기전에 위치 될 수 있다는것을 깨달아야만 한다. uApplicationToken멤버는 각각의 그런 이벤트의 디멀티플렉싱을 돕기위해 사용될수 있다.

이미 발생한 OID_WW_GEN_INDICATION_REQUEST를 취소하기위한 어떤 시도는 하위 드라이버에의해 무시될수 있다.

많은 OID_WW_GEN_INDICATION_REQUEST들은 특정한 OID에대해 두드러질수 있다. 이 OID로 NdisRequest함수의 여러 호출들을 만드는것은 여러 트리거 포인트들을 설정할 수 있다. 여러 OID_WW_GEN_INDICATION_REQUEST들중 하나는 이벤트 알림을 야기한다. 단지 그 트리거만이 취소되고, 모든 다른 OID_WW_GEN_INDICATION_REQUEST들은 인에이블된체 남아 있다.

NDIS는 미니포트 드라이버의 이벤트 알림을 그 하위 드라이버와 직렬로 바인딩된 모든 프로토콜에게 전달한다. 결과적으로, 닉 드라이버는 인디케이션 요청의 내용을 복사해야만 한다. 닉 드라이버는 내부적인 이벤트 큐에대한 요청을 스케줄링하기전에 그리고 정보설정 루틴의 호출로부터 리턴하기전에 hIndicationHandle값을 채워야만 한다. 이것은 바인딩된 프로토콜이 그들이 발생할때 그들 소유의 각각의 이벤트의 알림을 발견할수 있단는것을 확신한다. 결과적으로, 미니포트 드라이버는 이 요청을 처리하는 그런 단조롭게 증가하는 32비트 값(전송 ID)인 고유한 각 시기에 발생하지 않는 충돌을 확실히 하기위한 hIndicationHandle내의 값을 설정해야만 한다.

미니포트 드라이버가 이 OID에대한 이벤트를 인디케이트 할때, NdisMIndicateStatus함수를 호출할 때 Status파라미터로써 인디케이트 요청의 복사본에게 포인터를 넘긴다. 인디케이션을 받는 바인딩된 프로토콜 드라이버들은 어떤 특정한 프로토콜이 hIndicationHandle값을 그 프로토콜과 관계된 이벤트를 인디케이트 하는것을 결정하도록 하면서 인디케이트도니 정보를 그들 소유의 내부 버퍼 공간으로 복사해야만 한다.

일반적인 룰로써, 모든 프로토콜은 이벤트 알림이 만들어지고 각 프로토콜의 ProtocolStatus함수가 인디케이트된 이벤트가 연관된지를 결정하자마자 컨추럴을 리턴할때 hIndicationHandle값을 체크해야만 한다. 그렇지 않으면, 모든 바인딩된 프로토콜들에게 미니포트의 이벤트를 알리는 효과는 미니포트 드라이버와 모든 바인딩된 프로토콜들에 있어 퍼포먼스에서 하락한다.

이벤트 데이타는 ProtocolStatus함수가 컨추럴을 리턴할때까지만 유효화 하도록 보장한다. NdisMIndicateStatus함수로 부터 리턴하자마자, 미니포트 드라이버를 인디케이트 하는것은 지정된 이벤트에대한 모든 컨텍스트를 해제 할수 있다.

쿼리와 인디케이션들은 이 OID에대해 관계가 없다.

OID_WW_GEN_DEVICE_INFO

이 OID는 미니포트 드라이버에게 닉에대한 초기화 시간 정보를 리턴하도록 요청한다.

이 요청은 다음과 같은 WW_DEVICE_INFO구조체를 사용한다. 


typedef struct _WW_DEVICE_INFO{

    NDIS_VAR_DATA_DESC    Manufacturer; // WCHAR buffer

    NDIS_VAR_DATA_DESC    ModelNum;     // WCHAR buffer

    NDIS_VAR_DATA_DESC    SWVersionNum; // WCHAR buffer

    NDIS_VAR_DATA_DESC    SerialNum;    // WCHAR buffer

} WW_DEVICE_INFO;

이 구조체의 멤버는 다음 정보를 포함한다.

Manufacturer
보여줄수 있는 Unicode텍스트내의 닉 제조업자의 이름을 포함하는 버퍼를 가리킨다.

ModelNum
보여줄수 있는 Unicode텍스트내의 닉의 제조업자 할당 모델 넘버를 포함하는 버퍼를 가리킨다.

SWVersionNum
보여줄수 있는 Unicode텍스트내의 닉 소프트웨어/펌웨어의 제조업자 할당 버전 넘버를 포함하는 버퍼를 가리킨다.

SerialNum
보여줄수 있는 Unicode텍스트내의 닉의 제조업자 할당 직렬 넘버를 포함하는 버퍼를 가리킨다.

셋과 지시들은 이 OID에서 부적절하다.

OID_WW_GEN_OPERATION_MODE

질의로써, 이 OID는 미니포트 드라이버에게 닉의 현재 파워 저장 모드에대한 정보를 리턴한다.

설정으로써, 이 OID는 미니포트 드라이버에게 요청된 파워 모드로 닉을 설정하도록 요청한다.

각 경우에, 이 요청은 다음 값중 하나를 사용한다.

Value Meaning
0 Normal mode
1 Power-saving mode
-1 Mode unknown

미니포트 드라이버는 만약 NDIS_REQUEST의 InformationBuffer에 주어진 값이 무효하거나 -1이면, NDIS_STATUS_INVALID_DATA를 리턴해야만 한다.

만약 어떤 바인딩된 프로토콜이 OID_WW_GEN_INDICATION_REQUEST로 인디케이션을 인에이블하면, 미니포트 드라이버는 만약 닉의 파워 모드가 변했다면, 프로토콜에게 알리기위해 NdisMIndicateStatus함수를 호출해야한다. OID_WW_GEN_INDICATION_REQUEST내에 지정된 TriggerValue값을 무시할 수 있다.

OID_WW_GEN_LOCK_STATUS

이 OID는 미니포트 드라이버에게 다음값중 하나로써 닉의 현재 락 상태에대한 정보를 리턴하도록 요청한다.:

Value Meaning
0 Unlocked
1 Locked
-1 Lock status unknown

몇몇 무선 장치들은 장치를 락하기위해 외부 메카니즘들을 지원한다. 만약 이 OID가 장치가 락된것은 인디케이트 한다면, 네트웍으로의 접근은 몇몇 방법에서 제한된다.

만약 어떤 바인딩된 프로토콜이 OID_WW_GEN_INDICATION_REQUEST로 인디케이션을 인에이블한다면, 미니포트 드라이버는 만약 닉의 락 상태가 변한다면, 그 프로토콜에게 알리기위해 NdisMIndicateStatus함수를 호출해야만 한다. OID_WW_GEN_INDICATION_REQUEST내에 지정된 TriggerValue멤버는 무시 할수 있다.

닉은 이 OID요청으로 락되거나 언락될수 있다. 즉, 설정들은 이 OID에대해 관련이 없다.

OID_WW_GEN_DISABLE_TRANSMITTER

질의로써, 이 OID는 미니포트 드라이버에게 닉의 현재 전송자의 상태를 리턴하도록 요청한다.

설정으로써, 이 OID는 미니포트 드라이버에게 닉의 전송자를 요청된 상태로 넣으라는 요청을 한다.

어느 한경우에, 이 요청은 다음중 하나의 값을 사용한다.:

Value Meaning
0 Transmitter enabled
1 Transmitter disabled
-1 Transmitter state unknown

이 OID에대한 일반적인 사용은 시스템혹은 사용자 트래픽에 연연하지않고 즉시 닉의 전달자를 디스에이블한다. 이 OID의 영향은 특정한 닉에 의존한다. 몇몇 닉들은 단지 물리적으로 전달자를 디스에이블할지 모른다. 다른 닉들은 완전히 셧다운하여 수용을 디스에이블 한다. 미니포트 드라이버는 만약 이 요청에대한 NDIS_REQUEST의 InformationBuffer에 값이 무효하거나 -1이면, NDIS_STATUS_INVALID_DATA를 리턴해야만 한다.

만약 어떤 바인딩된 프로토콜이 OID_WW_GEN_INDICATION_REQUEST로 인디케이션을 인에이블한다면, 미니포트 드라이버는 만약 닉의 전달자의 상태가 변한다면 프로토콜에게 알리기위해 NdisMIndicateStatus함수를 호출해야만 한다. OID_WW_GEN_INDICATION_REQUEST내에 지정된 TriggerValue멤버를 무시 할수 있다.

OID_WW_GEN_NETWORK_ID

질의로써, 이 OID는 미니포트 드라이버에게 닉이 현재 통신하기위해 구성된 네트웍 ID를 리턴하도록 요청한다.

설정으로, 이 OID는 미니포트 드라이버에게 주어진 ID로 설계된 네트웍으로 통신하기위해 닉을 재구성하도록 요청한다.

이 요청은 이전에 정의된 NDIS_VAR_DATA_DESC구조체와 동등하게 정의된 WW_NETWORK_ID구조체로써 사용된다. 버퍼는 바이너리 바이트 값의 네트웍 순서화된 순서를 포함한다.

만약 어떤 바인딩된 프로토콜이 OID_WW_GEN_INDICATION_REQUEST로 인디케이션을 인에이블한다면, 미니포트 드라이버는 만약 닉이 통신하는 네트웍이 변한다면 프로토콜에게 알리기위해 NdisMIndicateStatus함수를 호출해야만한다.

OID_WW_GEN_PERMANENT_ADDRESS

이 OID는 미니포트 드라이버에게 본연의 형태의 닉의 네트웍 어드레스를 리턴하도록 요청한다. 드라이버가 현재 사용하고 있는 헤더 형식이 무엇이건간에.

이전에 정의된 NDIS_VAR_DATA_DESC구조체의 동등하게 정의된이 요청은 WW_PERMANENT_ADDRESS구조체를 사용한다. 버퍼는 네트웍 순서화된 바이너리 바이트 값의 순서를 포함한다.

설정과 인디케이션들은 이 OID에대해 연관이 없다.

OID_WW_GEN_CURRENT_ADDRESS

질의로써, 이 OID는 미니포트 드라이버에게 지정된 형식으로 닉에의해 사용된 어드레스를 리턴하도록 요청한다. 초기화에, 미니포트 드라이버는 OID_WW_GEN_PERMANENT_ADDRESS에대해 리턴된 값의 대한 현재 어드레스를 설정한다.

설정으로써, 이 OID는 미니포트 드라이버에게 현재 어드레스를 변화하도록 요청한다.

OID_WW_GEN_HEADER_FORMATS_SUPPORTED로 리스트된 지원하는 헤더 포맷들중 하나이어야만 하는 현재 어드레스의 포맷은 헤더 포맷에 의존한다.

이 요청은 다음과 같이 정의된 WW_CURRENT_ADDRESS구조체를 사용한다.: 


typedef struct _WW_CURRENT_ADDRESS {

    NDIS_WW_HEADER_FORMAT    Format;

    NDIS_VAR_DATA_DESC       Address;

} WW_CURRENT_ADDRESS;

이 구조체의 멤버는 다음 정보를 포함한다.:

Format
OID_WW_GEN_HEADER_FORMATS_SUPPORTED로 리스트된 시스템 정의 NdisWW..Frames값들중 하나를 지정한다. 만약 들어오는 설정 요청이 NdisWW..Frames이외의 다른 것을 제공한다거나 하위 드라이버가 제공하지않는 어떤 값을 제공한다면, 드라이버는 NDIS_STATUS_NOT_SUPPORTED를 리턴한다.

Address
닉에의해 사용되는 지역(station)어드레스를 포함하는 버퍼를 설명한다. 미니포트 드라이버는 Format의 값으로 호환될수 있어야하는 이 값을 원래의 포맷으로 닉의 주소를 멥한다. 버퍼는 네트웍 순서화된 바이너리 바이트값의 순서를 포함한다.

만약 들어오는 설정 요청이 무효한 어드레스 지정을 제공한다면 드라이버는 NDIS_STATUS_INVALID_DATA를 리턴한다.

현재 어드레스는 같은 닉 미니포트 드라이버와 바인딩된 모든 프로토콜들에대해 동일하다. 요청된 변화는 모든 바인딩된 프로토콜들에게 영향을 미친다.

만약 어떤 바인딩된 프로토콜이 OID_WW_GEN_INDICATION_REQUEST로의 인디케이션이 인에이블되면, 미니포트 드라이버는 만약 현재 어드레스가 변한다면 프로토콜에게 알리기위해 NdisMIndicateStatus함수를 호출한다. 만약 현재 어드레스가 알려지지 않는다면, 미니포트 드라이버는 WW_CURRENT_ADDRESS의 Address멤버의 Length멤버를 인디케이션에대해 0으로 설정해야한다. OID_WW_GEN_INDICATION_REQUEST내에 지정된 TriggerValue멤버는 무시할 수 있다.

OID_WW_GEN_SUSPEND_DRIVER

질의로써, 이 OID는 미니포트 드라이버에게 현재 지연상태를 리턴하도록 요청한다.

설정으로써, 이 OID는 미니포트 드라이버에게 현재 지연 상태의 변화를 요청한다.

각경우에, 이 요청은 다음 값중 하나를 사용한다.:

Value Meaning
Value Meaning
0 Driver operational
1 Driver suspended

미니포트 드라이버가 스스로를 지연할때, 연상 상태에서 사용하는 직렬 포트와 같은 어떤 하드웨어 리소스들은 해제 해야만한다. 이 연산은 엔드 유저가 또다른 사용을 위해 NDIS드라이버가 사용했던 같은 직렬 포트에서의 직렬 장치에 대한 보내는 AT명령들과 같은 하드웨어 리소스를 재 할당하기를 원할때 컨추럴 패널에서 초기화될 수 있다.

만약 어떤 바인딩된 프로토콜이 OID_WW_GEN_INDICATION_REQUEST로 인디케이션들을 인에이블 한다면, 미니포트 드라이버는 만약 드라이버의 지연 상태가 변한다면 프로토콜에게 알리기위해 NdisMIndicateStatus함수를 호출해야만 한다. OID_WW_GEN_INDICATION_REQUEST내에 지정된 TriggerValue멤버는 무시할수 있다.

OID_WW_GEN_BASESTATION_ID

이 OID는 미니포트드라이버에게 베이스 지역(station)의 ID를 리턴하도록 요청하거나 닉에의해 접근된 마지막 특정 장치의 ID를 리턴하도록 요청한다.

이 요청은 이전에 정의된 NDIS_VAR_DATA_DESC구조체와 동일하게 정의된 WW_BASESTATION_ID구조체를 사용한다. 버퍼는 바이너리 바이트 값의 네트웍 순서화된 순서를 포함한다.

만약 어떤 바인딩된 프로토콜은 OID_WW_GEN_INDICATION_REQUEST로 인디케이션을 인에이블 한다면, 미니포트 드라이버는 만약 basestation ID값이 변하면 프로토콜에게 알리기위해 NdisMIndicateStatus함수를 호출해야만 한다.

설정은 이 OID에대해 해당하지 않는다.

OID_WW_GEN_CHANNEL_ID

이 OID는 미니포트 드라이버에게 사용중인 현재 채널의 ID를 리턴하도록 요청한다.

이 요청은 이전에 정의된 NDIS_VAR_DATA_DESC구조체와 동일하게 정의된 WW_CHANNEL_ID구조체를 사용한다. 버퍼는 바이너리 바이트 값의 네트웍 순서화된 순서를 포함한다.

만약 어떤 바인딩된 프로토콜이 OID_WW_GEN_INDICATION_REQUEST로 인디케이션을 인에이블 한다면, 미니포트 드라이버는 만약 체널 ID값이 변하면 프로토콜에게 알리기위해 NdisMIndicateStatus함수를 호출해야만 한다. OID_WW_GEN_INDICATION_REQUEST에 지정된 TriggerValue멤버를 무시 할수 있다.

설정은 이 OID에 연관이 없다.

OID_WW_GEN_ENCRYPTION_SUPPORTED

이 OID는 미니포트 드라이버에게 드라이버와/혹은 닉에의해 지원되는 암호화 타입을 리턴하도록 요청한다. 다음은 NDIS_WW_ENCRYPTION_TYPE 목록으로부터 유효한 암호화 타입을 나열한다.

NdisWWUnknownEncryption
드라이버는 암호화에대한 지원이 닉으로부터 이용할수 있는지를 결정할수 없다.

NdisWWNoEncryption
암호화에대한 어떤 지원도 이용할수 없다.

NdisWWDefaultEncryption
닉은 암호화를 지원하지만 드라이버는 어떤 타입의 암호화를 지원하는지를 결정할수 없다.

NdisWWDESEncryption
닉은 DES암호화를 지원한다.

NdisWWRC2Encryption
닉은 RC2암호화를 지원한다.

NdisWWRC4Encryption
닉은 RC4암호화를 지원한다.

NdisWWRC5Encryption
닉은 RC5암호화를 지원한다.

추가적인 NDIS_WW_ENCRYPTION_TYPE값이 정의될때, 미니포트 드라이버는 지원되는 암호화 타입을 인디케이트하는 값의 배열을 리턴해야 한다.

설정과 인디케이션은 이 OID에 해당 되지 않는다.

OID_WW_GEN_ENCRYPTION_IN_USE

질의로써, 이 OID는 미니포트 드라이버에게 사용중인 현재의 암호와 타입을 리턴하도록 요청한다. 가능한 값들에대해서는 OID_WW_GEN_ENCRYPTION_SUPPORTED를 보라.

설정으로써, 이 OID는 미니포트 드라이버에게 사용중인 암호화 타입의 변화 하도록 요청한다. 미니포트 드라이버는 만약 NdisWWUnknownEncryption가 지정되면 NDIS_STATUS_INVALID_DATA를 리턴한다.

만약 어떤 바인딩된 프로토콜은 OID_WW_GEN_INDICATION_REQUEST로 인디케이션을 인에이블한다면, 미니포트 드라이버는 만약 암호화 타입이 변하면 프로토콜에게 알리기위해 NdisMIndicateStatus함수를 호출해야만 한다. OID_WW_GEN_INDICATION_REQUEST에서 지정된 TriggerValue멤버를 무시할수 있다.

OID_WW_GEN_ENCRYPTION_STATE

질의로써, 이 OID는 미니포트 드라이버에게 만약 현재 선택된 암호화 타입이 디스에이블 된다면 FALSE를 리턴하도록 요청한다.

설정으로써, 이 OID는 미니포트 드라이버에게 인에이블 혹은 디스에이블하는 암호화를 요청한다. TRUE는 미니포트 드라이버에게 인에이블 암호화를 다이렉트한다.

각 경우에, 미니포트 드라이버는 만약 미니포트 드라이버혹은 닉이 암호화를 지원하지 않는다면 NDIS_STATUS_NOT_SUPPORTED를 리턴해야 한다.

만약 어떤 바인딩된 프로토콜이 OID_WW_GEN_INDICATION_REQUEST로 인디케이션을 인에이블한다면, 미니포트 드라이버는 만약 암호화 상태가 변하면 프로토콜에게 알리기위해 NdisMIndicateStatus함수를 호출한다. OID_WW_GEN_INDICATION_REQUEST로 지정된 TriggerValue값은 무시될 수 있다.

OID_WW_GEN_CHANNEL_QUALITY

이 OID는 미니포트 드라이버에게 다음처럼 닉과 네트웍사이의 네트웍 질에대한 정보를 리턴하도록 요청한다.:

Value Meaning
0 무선 닉은 네트웍으로 접촉하지 않는다.
1-100 드라이버는 링크에대한 주어진 질에 베이스 지역(station)과 통신할수 있다. 일반적인 값이다. 100은 최고의 링크 질을 나타낸다.

만약 닉이 네트웍 접촉의 내부에있는지 혹은 밖에있는지만을 인디케이트 한다면, 드라이버는 접촉 밖으로 0을 리턴하고 접촉으로 100을 리턴한다.

-1 채널 질은 알려지지 않는다.

하위 무선 WAN닉에의해 네트웍 접촉의 IN/OUT상태를 간단히 모니터하는 어떤 바인딩된 프로토콜은 OID_GEN_MEDIA_CONNECT_STATUS로 NdisRequest를 호출하거나 미니포트 드라이버에의해 NDIS_STATUS_MEDIA_[DIS]CONNECT인디케이션에대한 기다린다.

만약 어떤 바인딩된 프로토콜이 OID_WW_GEN_INDICATION_REQUEST로 인디케이션을 인에이블 한다면, 미니포트 드라이버는 OID_WW_GEN_INDICATION_REQUEST내에 지정된 TriggerValue에따라 프로토콜에게 알리기위해 NdisMIndicateStatus함수를 호출해야만 한다.

설정은 이 OID에대해 연관이 없다.

OID_WW_GEN_REGISTRATION_STATUS

이 OID는 미니포트 드라이버에게 다음과 같은 네트웍에서의 닉의 현재 등록상태를 리턴하도록 요청한다.

Value Meaning
0 등록을 거부한다.
1 등록은 네트웍에서 지연되고있다.
2 네트웍에서 등록됐다.

만약 특정한 네트웍이 등록 정보를 제공하지 않는다면, 미니포트 드라이버는 항상 이 OID요청의 응답으로 리턴한다. 그런 네트웍에서의 닉은 등록된 상태로 항상 간주한다.

-1 등록 상태는 알려지지 않았다.

만약 어떤 바인딩된 프로토콜이 OID_WW_GEN_INDICATION_REQUEST로 인디케이션을 인에이블하면, 미니포트 드라이버는 만약 등록상태가 변하면 그런 프로토콜에게 알리기위해 NdisMIndicateStatus함수를 호출한다. OID_WW_GEN_INDICATION_REQUEST에서 지정된 TriggerValue멤버는 무시할수 있다.

이 OID에대해 설정은 연관이 없다.

OID_WW_GEN_RADIO_LINK_SPEED

이 OID는 미니포트 드라이버에게 bps의 라디오(radio) 링크 스피드를 리턴한다. 리턴값은 UINT형이다.

설정은 이 OID에서 사용하지 않는다.

OID_WW_GEN_LATENCY

이 OID는 미니포트 드라이버에게 무선 네트웍 사이에서 하나의 엔드 포인트에서 다른 엔드포인트까지의 네트웍에의해 허용된 최대 사이즈의 넷 패킷을 보내는것에대한 현재의 밀리초 단위의 최소 대기 시간의 추정을 리턴하도록 요청한다. 리턴 값은 UINT형이다.

미니포트 드라이버는 이 질의에대한 상수 값을 리턴한다. 지연 시간의 추정을 고치는 NIC드라이버는 동적으로 스스로 "autotune"하는 바인딩된 프로토콜에게 유용한 정보를 제공한다.

설정은 이 OID에대해 사용하지 않는다.

OID_WW_GEN_BATTERY_LEVEL

이 OID는 미니포트 드라이버에게 다음과 같은 현재 베터리의 충전량을 리턴하도록 한다.:

Value Meaning
Value Meaning
0-100 퍼센트로써 베터리의 충전, 100은 완전 충전을 의미한다.
-1 충전 상태는 알려지지 않았다.

만약 어떤 바인딩된 프로토콜이 OID_WW_GEN_INDICATION_REQUEST로 인디케이션을 인에이블 한다면, 미니포트 드라이버는 OID_WW_GEN_INDICATION_REQUEST내에 지정된 TriggerValue에 따라 그런 프로토콜들에게 알리기위해 NdisMIndicateStatus함수를 호출해야만 한다.

설정은 OID에서 사용하지 않는다.

OID_WW_GEN_EXTERNAL_POWER

이 OID는 미니포트 드라이버에게 다음과 같이 닉에게 연결된 어떤 외부 파워 소스에대한 정보를 리턴하도록 요청한다.

Value Meaning
0 어떤 외부 파워 소스가 연결되지 않았다.
1 외부 파워가 연결됐다.
-1 알려지지 않았다.

만약 어떤 바인딩된 프로토콜이 OID_WW_GEN_INDICATION_REQUEST로 인디케이션을 인에이블한다면, 미니포트 드라이버는 만약 외부 파워 연결상태가 변하면 그런 프로토콜에게 알리기위해 NdisMIndicateStatus함수를 호출해야만 한다. OID_WW_GEN_INDICATION_REQUEST내에 지정된 TriggerValue멤버는 무시할 수 있다.

설정은 이 OID에대해 사용하지 않는다.

OID_WW_GEN_PING_ADDRESS

설정으로써, 이 OID는 하위 미니포트 드라이버와 NIC에게 현재 연결된 무선 네트웍을통해 지정된 노드로 에코 요청 연산을 위한 진단 패킷을 보내라고 요청한다. 이 OID의 유일한 의도는 프로토콜과 어플리케이션에게 두가지 방법의 통신이 현재 연결된 네트웍에서 리모트 노드에게 설정될 수 있는지를 결정하도록 한다. 어떤 네트웍들에서는, 추가적인 기능이 전체 end-to-end연결이 성립될수 있는지를 검사하기위해 제공될 수도 있다. 이 OID는 OPTIONAL로써 설정된다.

질의로써, 이 OID는 하위 미니포트 드라이버와 NIC에게 리모트 노드가 무선 네트웍에 연결됐는지를 결정하기위한 이전의 에코 연산의 결과에대한 정보를 리턴하도록 요청한다.

이 요청은 다음과 같은 WW_PING_ADDRESS구조체를 사용한다.: 


typedef struct _WW_PING_ADDRESS {

    IN  WW_ADDRESS_FORMAT     Format; 

    IN  NDIS_VAR_DATA_DESC    TargetAddress; 

    OUT UINT                  uTime; 

} WW_PING_ADDRESS;

이 구조체의 멤버들은 다음의 정보를 포함한다.

Format
리모트 노드의 어드레스 형식은 TargetAddress에의해 지정된다. 이 어드레스 포맷은 WW_ADDRESS_FORMAT의 열거에서 포함된 값들중 하나이어야만 한다. 아래의 리스트들은 유효한 값들이다.

WW_IEEE_ADDRESS
네트웍 바이트 순서의 48비트 IEEE어드레스.

WW_MOBITEX_MAN_ADDRESS
네트웍 바이트 순서의 Mobitex접근 넘버.

WW_DATATAC_RDLAP_ADDRESS
네트웍 바이트 순서의 DataTAC RDLAP어드레스.

WW_DATATAC_MDC4800_ADDRESS
네트웍 바이트 순서의 DataTAC MDC 4800어드레스.

WW_DATATAC_RESERVED
DataTAC네트웍에의해 예약된다.

WW_IPv4_ADDRESS
네트웍 순서의 IP버전 4 어드레스

WW_IPv6_ADDRESS
네트웍 바이트 순서의 IP버전 6 어드레스

WW_PROPRIETARY_ADDRESS
어드레스는 소유자의 형식으로 지정된다. 미니포트 드라이버는 어드레스가 나타내지는 형식을 디코드해야만 한다.

만약 들어도는 에코 요청 연산이 이전의 값들중의 하나이외의 어떤것을 제공하거나 하위 드라이버가 지원하지 않는 값을 제공한다면, 하위 드라이버는 NDIS_STATUS_NOT_SUPPORTED가 리턴된다.

TargetAddress
리모트 노드에의해 사용되는 지역(station)네트웍 어드레스를 포함하는 버퍼를 설명하는 NDIS_VAR_DATA_DESC형을 지정한다. 미니포트 드라이버는 이 어드레스를 현재 연결된 무선 네트웍의 원천 주소와 멥한다. 이것은 Format의 값과 호환되어야만 한다. 버퍼내의 어드레스는 네트웍 바이트 순서로 나타내어진다. 브로드 케스트혹은 그룹 어드레스는 이 연산에대해 무효하고 미니포트 드라이버는 NDIS_STATUS_INVALID_DATA를 리턴해야만 한다.

uTime
에코 요청 연산을 완료하는것에대한 밀리초 단위의 시간 길이를 지정한다. 이 연산은 미니포트 드라이버에게 리모트 노드에게 진단 패킷을 전송하도록 요청하고 리모트 노드로부터 응답을 받는다. 이 멤버는 전송과 응답사이의 경과하는 시간을 지정한다. 값중 1은 에코 요청 연산의 실패를 나타낸다. 인디케이션은 이 OID에대해 사용하지 않는다.

지시들은 이 OID에 부적절하다.

OID_WW_GEN_RSSI

이 OID는 하위 미니포트 드라이버에게 미니포트 드라이버의 NIC이 수신하는 데시벨(dB)로의 시그널의 세기를 지정하는 정보를 리턴하도록 요청한다. 이 OID는 OID_WW_GEN_CHANNEL_QUALITY가 리턴하는 일반적인 값에대한 최초의 시그널 세기를 요청한다. 프로토콜과 어플리케이션은 이 최초의 시그널 세기정보를 기술적인 디버깅 목적으로 돕기위해 얻을수 있다. 이 OID는 OPTIONAL로써 정의된다.

이 요청은 다음과 같은 WW_RECEIVE_SIGNAL_STRENGTH_INDICATOR구조체를 사용한다. 


typedef struct _WW_RECEIVE_SIGNAL_STRENGTH_INDICATOR {

    OUT INT  iDecibels; 

    OUT INT  iFactor; 

} WW_RECEIVE_SIGNAL_STRENGTH_INDICATOR;

이 구조체의 멤버는 다음의 정보를 포함한다.

iDecibels
최초의 시그널 세기 측정에대한 데시벨(dB)값.

iFactor
최초 시그널 세기 측정에대한 기본 10의 파워.

만약 iDecibels이 3dB이고 iFactor가 2이면, 수신된 시그널의 세기는 3 * (10^2) = 300 dB이다.

설정과 인디케이션은 이OID에서 사용하지 않는다.

OID_WW_GEN_SIM_STATUS

이 OID는 하위 미니포트 드라이버에게 NIC이 결부된Subscriber Information Module (SIM)을 가지고 있다면 지정하는 정보를 리턴하도록 한다. 이 OID는 만약 Personal Identification Number (PIN)이 NIC에게 접근하기위해 SIM을 위해 들어가야되도록 요구된다면 SIM에대한 정보를 요청한다. 이 OID는 OPTIONAL로써 정의된다.

이 요청은 다음과 같은 WW_SIM_STATUS구조체로써 사용된다. 


typedef struct _WW_SIM_STATUS {

    OUT BOOLEAN  bHasSIM; 

    OUT BOOLEAN  bBlocked; 

    OUT BOOLEAN  bLocked; 

    OUT BOOLEAN  bInitialized; 

    OUT UINT     uCountdown; 

} WW_SIM_STATUS;

이 구조체의 멤버들은 다음과 같은 정보를 포함한다.

bHasSIM
만약 하위 미니포트 드라이버가 NIC에게 접근하기위해 SIM을 요구하면 TRUE를 SIM을 요구하지 않으면FALSE 인 Boolean값이다.

bBlocked
PIN을 사용하는 SIM에대한 접근이 막힌다면 TRUE를 PIN이 SIM을 unlock할수 있다면 FALSE인 Boolean값이다.

bLocked
만약 하위 민니포트 드라이버가 닉에게 접근하기위해 SIM에대해 있어야할 PIN을 요구하면 TRUE를 그렇지 않으면 FALSE인 Boolean값이다.

bInitialized
만약 SIM이 이미 PIN과함께 초기화됐다면 TRUE를 PINDL SIM에대해 결코 설정하지 않는다면 FALSE인 Boolean이다.

uCountdown
올바른 PIN에 들어가기위해 사용자들이 사용할수 있는 남아있는 시도 횟수를 지정한다. 만약 이 값이 0이고 PIN이 bLocked으로 지정되는 것으로써 요구된다면, 사용자들은 더이상 PIN에 들어갈수없다. 이러한 경우, NIC의 SIM은 unlocking서비스에대해 리턴되거나 만약 수행된다면, OID_WW_GEN_SIM_PUK은 올바른 PIN에 들어가는것에대한 더 많은 시도들을 인에이블하기위해 uCountDown을 리셋하는데 사요되어야만 한다.

SIM들은 스마트 카드로써 가리켜진다. SIM들은 두 Global System for Mobile (GSM)와 Code Division Multiple Access (CDMA)통신 표준에서 기본이되는 무선 전화들에서 사용된다. SIM들은 호출 계획들과 개인적으로 다른 폰 정보를 확인한다. 그러므로, 콜 계회과 다른 폰 정보는 SIM들과 링크되고 폰들과는 링크되지 않는다. 예를들어, 만약 개인이 새로운 무선폰을 구입하고 새로운 무선폰과 예전 무선폰이 호환SIM들을 지원하면, 그는 그의 무선 서비스 제공자와 접촉할 필요가 없다. 그는 간단히 그의 예전 폰으로부터 SIM을 제거하고 새로운 폰을 넣으면 된다. 그의 폰 넘버는와 서비스 계획은 그의 새로운 폰으로 전송된다.

SIM들은 사용자들이 그들의 PIN들을 폰에대한 키패드들에 넣을때까지 그들의 연관된 폰들을 락 할수 있는 보안 특징을 가지고 있다. 이 OID는 컴퓨터 카드와같은 키패드를 가지고 있지않은 장치들에대한 해결책으로써 소개되었다. 이 OID가 소개될때SIM을 unlock하기위해 제공된 프로그램적인 메카니즘이 없었다.

설정과 인디케이션들은 이 OID에대해 사용하지 않는다.

OID_WW_GEN_ENABLE_SIM_PIN

이 OID는 하위 미니포트에게 Subscriber Information Module (SIM)의 PIN보안 특징을 인에이블 하거나 디스에이블하도록 알린다. 이 OID는 OPTIONAL로써 정의된다.

이 요청은 다음과 같은 WW_ENABLE_SIM_PIN구조체를 사용한다. 


typedef struct _WW_ENABLE_SIM_PIN {

    IN  BOOLEAN             bEnabled; 

    IN  NDIS_VAR_DATA_DESC  CurrentPIN; 

} WW_ENABLE_SIM_PIN;

이 구조체의 멤버는 다음의 정보를 가지고 있다.:

bEnabled
만약 SIM에대한 PIN보안 특징이 인에이블이면 TRUE이고 SIM에대한 PIN이 디스에이블이면 FALSE인 Boolean값이다. TRUE값은 NIC 서비스의 접근이 허용되기전에 SIM에대한 올바른 PIN으로 들어가기위한 프로토콜들과 어플리케이션을 요구한다.

CurrentPIN
이전에 SIM으로 프로그램된 PIN을 포함하는 버퍼를 설명하는 NDIS_VAR_DATA_DESC형을 지정한다. 보안적인 이유로, 미니포트 드라이버는 PIN을 사용한후 혹은 PIN이 NIC의 서비스에 접근하도록 요구되지 않는다는것을 결정한후 PIN의 내부적인 카피본을 삭제해야한다.

SIM의 PIN보안 특징은 PIN이 폰에대한 키패드로 들어올때까지 삽인되는것에대한 폰을 락하기위해 사용된다. 이OID는 컴퓨터 카드와 같은 키패드를 가지고 있지않은 장치에대한 해결책으로써 소개되었다. 이 OID가 소개될때까지 SIM을 언락 하기위해 제공된 프로그램적인 메카니즘이 없었다.

만약 미니포트 드라이버의 NIC이 SIM을 사용하지 않는다면, 미니포트 드라이버는 SIM을 인에이블하거나 디스에이블하기위한 들어오는 요청들에대한 NDIS_STATUS_NOT_SUPPORTED의 에러값을 리턴한다.

질의와 인디케이션은 이 OID에대해 사용하지 않는다.

OID_WW_GEN_CHANGE_SIM_PIN

이 OID는 하위 미니포트 드라이버에게 Security Identification Module (SIM)으로 프로그램된 Personal Identification Number (PIN)을 수정하라고 알린다. 이 OID는 OPTIONAL로써 정의된다.

이 요청은 다음과 같이 정의된 WW_CHANGE_SIM_PIN구조체로써 사용된다.: 


typedef struct _WW_CHANGE_SIM_PIN {

    IN  NDIS_VAR_DATA_DESC  NewPIN; 

    IN  NDIS_VAR_DATA_DESC  OldPIN; 

} WW_CHANGE_SIM_PIN;

이 구조체의 멤버는 다음 정보를 가지고 있다.:

NewPIN
SIM으로 프로그램된 새로운PIN을 포함하는 버퍼를 설명하는 NDIS_VAR_DATA_DESC형을 지정한다.

OldPIN
이미 SIM으로 프로그램된 존재하는 PIN을 포함하는 버퍼를 설명하는 NDIS_VAR_DATA_DESC형을 지정한다.

보안적인 이유로, 미니포트 드라이버는 그들을 사용한후 두 PIN들의 내부적인 카피본을 삭제해야한다.

만약 미니포트 드라이버의 NIC이 SIM을 사용하지 않는다면, 미니포트 드라이버는 SIM으로 프로그램된 PIN을 수정하기위한 들어오는 요청들에대해 NDIS_STATUS_NOT_SUPPORTED의 에러값을 리턴해야한다.

질의와 인디케이션은 이 OID에대해 사용하지 않는다.

OID_WW_GEN_SIM_PUK

이 OID는 하위 미니포트 드라이버에게 Security Identification Module (SIM)으로 프로그램된 Personal Unblocking Key (PUK)에대해 알린다. 미니포트 드라이버는 이 PUK를 프로토콜과 어플리케이션이 SIM으로 올바른 PIN을 들여놓도록 할수 있어 NIC의 서비스들에 접근될수 있는 재시도의 횟수를 리셋하기위해 사용한다. 더많은 정보에대해서는 OID_WW_GEN_SIM_STATUS를 보라. 이 OID는 OPTIONAL로써 정의된다.

이 요청은 이전에 정의된 NDIS_VAR_DATA_DESC구조체와 동등하게 정의된 WW_ENABLE_SIM_PUK구조체를 사용한다. WW_ENABLE_SIM_PUK가 설명하는 버퍼는 바이너리 바이트 값으로 네트웍 순서화된 순서로써 SIM에대한 PUK를 포함한다.

보안적인 이유로, 미니포트 드라이버는 PUK를 사용한후 PUK의 내부적인 카피본을 삭제해야한다.

만약 미니포트 드라이버의 NIC이 SIM을 사용하지 않는다면, 미니포트 드라이버는 들어오는PUK알림에대한 NDIS_STATUS_NOT_SUPPORTED의 에러 값을 리터해야 한다.

질의와 인디케이션은 이 OID에대해 사용하지 않는다.

OID_WW_GEN_SIM_EXCEPTION

이 OID는 하위 미니포트 드라이버에게 다양한 SIM관련 조건들에대한 상태를 지정하는 정보를 리턴하도록 요청한다. 다음은 WW_GEN_SIM_EXCEPTION의 열거로부터 유효한 상태값들의 리스트이다. 이 OID는 OPTIONAL로써 정의된다.

SIM_STATUS_OK
SIM과 관련된 알려진 에러 조건이 없다.

SIM_STATUS_ERROR
일반적인 SIM관련 실패. 이 타입의 상태에러는 가능한 NIC의 SIM이 서비스에대해 리턴되어야한다는 것을 인디케이트한다.

SIM_STATUS_MISSING
SIM은 닉으로 삽입되지 않지만 NIC의 서비스를 접근할 필요가 있다.

SIM_STATUS_NO_RESPONSE
SIM은 NIC에 삽입되지만 요청에대한 응답이없다. 이 타입의 상태 에러는 가능한 NIC의 SIM이 서비스에대해 리턴되어야한다는것을 인디케이트 한다.

SIM_STATUS_REMOVED
SIM은 NIC으로부터 분리되었다.

SIM_STATUS_CRYPT_ERROR
SIM의 내용은 쓰레기 값이다. 이 타입의 상태 에러는 가능한 SIM이 불완전하거나 변조되었다는것을 인디케이트한다. 이 SIM은 서비스에대해 리턴되어야한다.

SIM_STATUS_AUTH_ERROR
SIM에대한 인증은 실패이다. 이 타입의 상태 에러는 가능한 SIM이 불완전하거나 변조되었다는것을 인디케이트한다. SIM은 서비스에대해 리턴되어야한다.

SIM_STATUS_NEED_PIN
SIM은 NIC의 서비스에대한 접근이 허락되기전에 PIN을 요구한다.

SIM_STATUS_NEED_PUK
SIM은 SIM으로 올바른 PIN을 들여놓기위해 프로토콜과 어플리케이션을 이용할수 있는 재시도 횟수를 리셋하기위해 PUK를 요구한다. 이 타입의 상태 에러는 SIM으로의 PIN의 엔트리가 이용할수 있는 시도 횟수를 초과했다는것을 인디케이트한다. 더많은 정보는 OID_WW_GEN_SIM_STATUS 와OID_WW_GEN_SIM_PUK르 보라.

SIM_STATUS_WRONG
SIM은 NIC으로 삽입되지만 NIC에대해 올바르지 않은 SIM이다. 즉, 이 특정한 타입의 SIM은 NIC과 호환이 아니다.

이 OID로의 질의는 가장 최근에 기록된 SIM관련 조건이다. 만약 어떤 바인딩된 프로토콜이 OID_WW_GEN_INDICATION_REQUEST로 인디케이션들을 인에이블한다면, 미니포트 드라이버는 만약 어떤 SIM 연산이 WW_GEN_SIM_EXCEPTION열거내의 상태 조건중 하나를 발생한다면 그런 프로토콜들에게 알리기위해 NdisMIndicateStatus함수를 호출해야만 한다. OID_WW_GEN_INDICATION_REQUEST내에 지정된 TriggerValue멤버를 무시할수 있다.

설정은 이 OID에대해 사용하지 않는다.