9.2 TAPI 정보 요청 설정하기

WAN 미니포트들은 완성 상태보다는 설정 요청을 위해서 어떠한 정보도 리턴하지 않는다. 모든 OID-특정 구조체들은 프로토콜 드라이버에 의해서 제공되고, 그들의 멤버들은 아래의 WAN NIC 미니포트에 읽기-전용이다.

OID_TAPI_ANSWER

이 OID 는 제공에서(on offer) 지정된 호출에 응답할 것을 요청한다. 추가적으로 그것은 미니포트가 호출 파티에게 지정된 사용자-to-사용자 정보를 보낼것을 요청한다.

이 요청에 대한 지원은 의무적이다.

OID_TAPI_ANSWER 요청은 아래에 정의된 NDIS_TAPI_ANSWER 구조체를 사용한다.: 


typedef struct _NDIS_TAPI_ANSWER { 

    IN ULONG      ulRequestID; 

    IN HDRV_CALL  hdCall; 

    IN ULONG      ulUserUserInfoSize; 

    IN UCHAR      UserUserInfo[1]; 

} NDIS_TAPI_ANSWER, *PNDIS_TAPI_ANSWER;

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

ulRequestID
예약됨.

hdCall
응답될 호출에 대한 미니포트의 핸들을 지정한다. 드라이버는 그것이 LINE_EVENT_NEWCALL 알림으로 NdisMIndicateStatus 를 호출했을 때 이 핸들을 설정한다.

ulUserUserInfoSize
UserUserInfo 에 있는 사용자-to-사용자 정보의 바이트 크기를 지정한다. 만약 이 멤버가 0이면, UserUserInfo 는 무시될수 있다.

UserUserInfo

호출 수락의 부분으로써 리모트 파티에게 보내질 사용자-to-사용자 정보를 포함하는 스트링을 지정한다. 사용자-to-사용자 정보는 만약 아래의 네트워크에 의해서 지원된다면 보내진다.(OID_TAPI_GET_DEV_CAPS를 봐라.)

MiniportSetInformation 함수는 아래중의 하나를 리턴할 수 있다.;
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_INVALCALLHANDLE
NDIS_STATUS_TAPI_INVALCALLSTATE
NDIS_STATUS_TAPI_RESOURCEUNAVAIL
NDIS_STATUS_TAPI_USERUSERINFOTOOBIG
NDIS_STATUS_FAILURE

OID_TAPI_ANSWER 요청의 성공적인 완성때, 미니포트는 OID_TAPI_GET_ID 요청에 대한 응답을 준비되어야 한다.

처음의 어플리케이션은 실제로 데이터를 쓰기전에 LINECALLSTATE_CONNECTED 알림을 기다려야한다.

OID_TAPI_CLOSE

이 OID 는 지정된 오픈 라인 장치를 닫을 것을 미니포트에게 요청한다.

이 요청에 대한 지원은 의무적이다.

이 요청은 아래에 정의된 NDIS_TAPI_CLOSE 구조체를 사용한다.: 


typedef struct _NDIS_TAPI_CLOSE { 

    IN ULONG      ulRequestID; 

    IN HDRV_LINE  hdLine; 

} NDIS_TAPI_CLOSE, *PNDIS_TAPI_CLOSE;

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

ulRequestID
예약됨.

hdLine
닫혀질 라인에 대한 미니포트의 핸들을 지정한다. 라인이 성공적으로 닫혀진후에, 이 핸들은 더이상 유효하지 않다.

MiniportSetInformation 함수는 아래중의 하나를 리턴할 수 있다.;
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING

OID_TAPI_CLOSE_CALL

이 OID 는 호출상에 있는 모든 나가는 비동기 요청들을 완료하고 종료한 후에 지정된 호출을 닫을것을 요청한다.

이 요청에 대한 지원은 의무적이다.

이 요청은 아래에 정의된 NDIS_TAPI_CLOSE_CALL 구조체를 사용한다.: 


typedef struct _NDIS_TAPI_CLOSE_CALL { 

    IN ULONG      ulRequestID; 

    IN HDRV_CALL  hdCall; 

} NDIS_TAPI_CLOSE_CALL, *PNDIS_TAPI_CLOSE_CALL;

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

ulRequestID
예약됨.

hdCall
닫혀질 호출에 대한 미니포트의 핸들을 지정한다. 호출이 성공적으로 닫혀진후에, 이 핸들은 더이상 유효하지 않다.

MiniportSetInformation 함수는 아래중의 하나를 리턴할 수 있다.;
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING

OID_TAPI_CONDITIONAL_MEDIA_DETECTION

클라이언트 어플리케이션이 라인들이 요구된 미디어 모드(들)과 호출 파라미터들을 지원하는 것을 찾기 위해서 스캔(scaned)될것을 요청하기 위해서 lineOpen 함수에 있는 dwDeviceID 로써 LINEMAPPER 를 사용할 때마다, NDISTAPI 는 WAN NIC 미니포트에게 아래로 그것을 통과시키는 NDISWAN 에 대한 OID 요청을 만든다.

NDISTAPI 스캔들은 그것이 동시에 요청된 미디어 모드들의 모든 것에 대해서 모니터할 수 있는 지를 알리기 위한 적절한 시기를 각각의 WAN 미니포트에게 주기 위해서, 라인상에서 모니터 될 수 있는 현재의 요구된 미디어 모드들과 다른 미디어 모드들의 유니온에 기반된다.

이 요청에 대한 지원은 의무적이다.

이 요청은 아래에 정의된 NDIS_TAPI_CONDITIONAL_MEDIA_DETECTION 구조체를 사용한다.: 


typedef struct _NDIS_TAPI_CONDITIONAL_MEDIA_DETECTION { 

    IN ULONG             ulRequestID; 

    IN HDRV_LINE         hdLine; 

    IN ULONG             ulMediaModes; 

    IN LINE_CALL_PARAMS  LineCallParams; 

} NDIS_TAPI_CONDITIONAL_MEDIA_DETECTION, *PNDIS_TAPI_CONDITIONAL_MEDIA_DETECTION;

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

ulRequestID
예약됨.

hdLine
미디어 모니터링과 파라미터능력들이 설정되는 라인에 대한 미니포트의 핸들을 지정한다.

ulMediaModes
호출 어플리케이션에 관심이 있는(interest) 현재 미디어 모드(들)을 지정한다.(애매??). 이 파라미터는 LINEMEDIAMODE 내용들을 사용한다. 세부적인 것은 ndistapi.h 을 봐라.

LineCallParams
LINE_CALL_PARAMS 구조체는 라인 장치가 제공해야하는 정보를 지정한다. 이 요청의 목적을 위한 유일한 관련된(relevent) 멤버는 아래이다.:

ULONG ulBearerMode;

ULONG ulMinRate;

ULONG ulMaxRate;

ULONG ulMediaMode;

ULONG ulCallParamFlags;

ULONG ulAddressMode;

만약 ulAddressMode 의 값이 LINEADDRESSMODE_ADDRESSID 이면, 라인상에 있는 어떤 주소는 수락할 수 있다. 그렇지 않으면, ulAddressMode 값은 미니포트가 지정된 originating 주소(폰 넘버)를 찾아야하거나 또는 만약 그것이 ulOrigAddressSize/Offset 와 the ulDevSpecificSize/Offset 값이 또한 관련이 있는, 제공자-특정 확장인지를 알리는 LINEADDRESSMODE_DIALABLEADDR 이다. LINE_CALL_PARAMS 구조체의 모든 다른 멤버들은 이 OID 요청에 관련이 없다.(irrelevant)

MiniportSetInformation 함수는 아래중의 하나를 리턴할 수 있다.;
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_INVALLINEHANDLE
NDIS_STATUS_TAPI_NODRIVER
NDIS_STATUS_TAPI_RESOURCEUNAVAIL
NDIS_STATUS_TAPI_INVALMEDIAMODE
NDIS_STATUS_FAILURE

만약 미니포트가 미디어 모드들의 지정된 집합에 대해서 모니터할 수 있고, CallParams에 지정된 능력들을 지원한다면, 그것은 NDIS_STATUS_SUCCESS으로 요청을 완성하지만, 그것은 변화되지않은 라인에 대한 액티브 미디어 모니터링 모드들을 그대로 둔다.

OID_TAPI_DROP

이 OID 는 지정된 호출을 드랍하거나 연결을 끊을 것을 요청한다.

사용자-to-사용자 정보는 추가적으로 호출 disconnect 의 부분으로써 전송될 수 있다. 이 요청은 어떤 때라고 어플리케이션에 의해서 만들어질 수 있다.

이 요청에 대한 지원은 의무적이다.

이 요청은 아래에 정의된 NDIS_TAPI_DROP 구조체를 사용한다.: 


typedef struct _NDIS_TAPI_DROP { 

    IN ULONG      ulRequestID; 

    IN HDRV_CALL  hdCall; 

    IN ULONG      ulUserUserInfoSize; 

    IN UCHAR      UserUserInfo[1]; 

} NDIS_TAPI_DROP, *PNDIS_TAPI_DROP;

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

ulRequestID
예약됨.

hdCall
드랍될 호출에 대한 미니포트의 핸들을 지정한다.

ulUserUserInfoSize
UserUserInfo에 있는 사용자-to-사용자 정보의 바이트 크기를 지정한다. 만약 이 멤버가 0이라면, 미니포트는 다음 멤버를 무시해야 한다.

UserUserInfo
호출 드랍의 부분으로써 리모트 파티에 보내질 사용자-to-사용자 정보를 포함하는 스트링을 지정한다. 사용자-to-사용자 정보는 단지 아래의 네트워크에 의해서 지원된다면 보내진다. (OID_TAPI_GET_DEV_CAPS 를 봐라)

MiniportSetInformation 함수는 아래중의 하나를 리턴할 수 있다.;
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_INVALCALLHANDLE
NDIS_STATUS_TAPI_INVALCALLSTATE
NDIS_STATUS_TAPI_USERUSERINFOTOOBIG
NDIS_STATUS_TAPI_RESOURCEUNAVAIL
NDIS_STATUS_FAILURE

미니포트가 이 요청을 성공적으로 완성할때, 호출은 아이들(idle) 상태에 있을 수 있다. 그러나, 미니포트는 그것이 이 핸들을 위해서 OID_TAPI_CLOSE_CALL 요청을 완성할 때까지 hdCall 핸들을 지정하는 통계 쿼리 같은 요청들을 여전히 수신할 수 있다.

OID_TAPI_PROVIDER_SHUTDOWN

어플리케이션이 더이상 TAPI 서비스들을 사용하지 않기때문에 TAPI 가 그것의 상태를 지울때, 이 OID 는 그것의 TAPI 연산들을 셧다운 할것을 미니포트에게 요청한다.

이 OID 를 제외하고, 미니포트는 그것이 처리중인 TAP와 연관된 어던 활동들을 종료해야하고, 현재 오픈하는 어떤 라인들에 대한 NDISWAN에게 NDIS_MAC_LINE_DOWN 로 NdisMIndicateStatus 를 호출해야하고, 그리고 TAPI 연산들을 더듬기(track) 위해서 사용하는 어떤 상태를 지워야한다.

이 요청에 대한 지원은 의무적이다.

이 요청은 아래에 정의된 NDIS_TAPI_PROVIDER_SHUTDOWN 구조체를 사용한다.: 


typedef struct _NDIS_TAPI_PROVIDER_SHUTDOWN { 

    IN ULONG  ulRequestID; 

} NDIS_TAPI_PROVIDER_SHUTDOWN, *PNDIS_TAPI_PROVIDER_SHUTDOWN;

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

ulRequestID
예약됨.

MiniportSetInformation 함수는 아래중의 하나를 리턴할 수 있다.;
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_RESOURCEUNAVAIL
NDIS_STATUS_FAILURE

OID_TAPI_SET_APP_SPECIFIC

이 OID 는 지정된 호출의 LINECALLINFO 구조체의 ulAppSpecific 멤버를 설정할 것을 미니포트에게 요청한다. 이 구조체의 세부적인 것은 ndistapi.h 을 봐라.

이 요청에 대한 지원은 의무적이다.

이 요청은 아래에 정의된 NDIS_TAPI_SET_APP_SPECIFIC 구조체를 사용한다.: 




typedef struct _NDIS_TAPI_SET_APP_SPECIFIC { 

    IN ULONG      ulRequestID; 

    IN HDRV_CALL  hdCall; 

    IN ULONG      ulAppSpecific; 

} NDIS_TAPI_SET_APP_SPECIFIC, *PNDIS_TAPI_SET_APP_SPECIFIC;

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

ulRequestID
예약됨.

hdCall
어플리케이션-특정 멤버가 설정되기 위한 호출에 대한 미니포트의 핸들을 지정한다.

ulAppSpecific
호출의 LINECALLINFO 구조체에 대한 ulAppSpecific 멤버의 새로운 내용을 지정한다. 이 값은 NIC 드라이버에 의해서 무관심된다.(uninterpreted). 이 값은 이 요청이 만들어질 때, NDISTAPI 에 의해서 입증되지(validated) 않는다.

MiniportSetInformation 함수는 아래중의 하나를 리턴할 수 있다.;
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_INVALCALLHANDLE
NDIS_STATUS_TAPI_RESOURCEUNAVAIL
NDIS_STATUS_FAILURE

OID_TAPI_SET_CALL_PARAMS

이 OID 는 존재하는 호출을 위해서 어떤 호출 파라미터들을 설정할 것을 미니포트에게 요청한다.

이 요청에 대한 지원은 의무적이다.

이 요청은 아래에 정의된 NDIS_TAPI_SET_CALL_PARAMS 구조체를 사용한다.: 


typedef struct _NDIS_TAPI_SET_CALL_PARAMS { 

    IN ULONG             ulRequestID; 

    IN HDRV_CALL         hdCall; 

    IN ULONG             ulBearerMode; 

    IN ULONG             ulMinRate; 

    IN ULONG             ulMaxRate; 

    IN BOOLEAN           bSetLineDialParams; 

    IN LINE_DIAL_PARAMS  LineDialParams; 

} NDIS_TAPI_SET_CALL_PARAMS, *PNDIS_TAPI_SET_CALL_PARAMS;

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

ulRequestID
예약됨.

hdCall
아래의 파라미터들이 변화되는 것을 위한 호출에 대한 미니포트의 핸들을 지정한다.

ulBearerMode
호출에 대한 새로운 전달자(bearer) 모드를 지정한다. 이 멤버는 단지 아래의 LINEBEARERMODE 플래그 설정중의 하나를 가질 수 있다.:

LINEBEARERMODE_VOICE

LINEBEARERMODE_SPEECH

LINEBEARERMODE_MULTIUSE

LINEBEARERMODE_DATA

LINEBEARERMODE_ALTSPEECHDATA

LINEBEARERMODE_NONCALLSIGNALING

ulMinRate
호출의 새로운 데이터 비율(rate)에 대한 아래의(lower) 바운드를 지정한다. 이 멤버의 값은 미니포트가 호출되기전에 NDISTAPI에 의해서 입증되지(validated) 않는다. 이 값은 호출자가 이것 만큼 낮게 새로운 비율(rate)를 수락할 것이라는것을 알린다.

ulMaxRate
호출의 새로운 데이터 비율(rate)에 대한 위의(upper) 바운드를 지정한다. 이 멤버의 값은 미니포트가 호출되기전에 NDISTAPI에 의해서 입증되지(validated) 않는다.

이 값은 호출자가 하고싶어하는(like) 최대 데이터 비율을 알린다.

호출자가 정확한 비율을 요구하는 것을 알리는 ulMinRate 와 ulMaxRate 멤버들에 대한 값은 똑같다.

bSetLineDialParams
아래의 다이어링 파라미터들이 호출을 위해서 사용될 지를 결정하낟. 만약 이 멤버가 FALSE 이면, 호출의 현재 다이얼링 파라미터들은 사용되어야하고 다음 멤버는 무시되어야한다.

LineDialParams

이 구조체는 호출에 대한 새로운 다이얼 파라미터들을 지정한다. 세부적인 것은 ndistapi.h 을 봐라.

MiniportSetInformation 함수는 아래중의 하나를 리턴할 수 있다.;
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_INVALCALLHANDLE
NDIS_STATUS_TAPI_INVALCALLSTATE
NDIS_STATUS_TAPI_INVALBEARERMODE
NDIS_STATUS_TAPI_BEARERMODEUNAVAIL
NDIS_STATUS_TAPI_INVALRATE
NDIS_STATUS_TAPI_RATEUNAVAIL
NDIS_STATUS_TAPI_RESOURCEUNAVAIL
NDIS_STATUS_FAILURE

OID_TAPI_SET_DEFAULT_MEDIA_DETECTION

이 OID 는 알려진 라인을 검출하기 위해서 새로운 미디어 모드들의 집합을 사용할 것을 미니포트에게 요청하다. 그 때문에, 그것이 사용중인 것을 설정할 때마다 대치한다.

미니포트는 이 요청이 들어오는 호출의 미디어 모드에 대해서 성공적으로 완성될때까지 들어오는 호출을 NDIWAN 에게 통지하지 않아야 한다.

이 요청에 대한 지원은 의무적이다.

이 요청은 아래에 정의된 NDIS_TAPI_SET_DEFAULT_MEDIA_DETECTION 구조체를 사용한다.: 


typedef struct _NDIS_TAPI_SET_DEFAULT_MEDIA_DETECTION { 

    IN ULONG      ulRequestID; 

    IN HDRV_LINE  hdLine; 

    IN ULONG      ulMediaModes; 

} NDIS_TAPI_SET_DEFAULT_MEDIA_DETECTION, *PNDIS_TAPI_SET_DEFAULT_MEDIA_DETECTION;

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

ulRequestID
예약됨.

hdLine
설정되야하는 기본 미디어 모드를 위한 라인에 대한 미니포트의 핸들을 지정한다.

ulMediaModes
NDISTAPI 에 관심이 있는 미디어 모드(들)을 지정한다. 이 멤버는 하나 이상의 LINEMEDIAMODE 상수들(constants)을 설정한다. 세부적인 것은 ndistapi.h 을 봐라.

이 요청은 아래에 정의된 NDIS_TAPI_SET_CALL_PARAMS 구조체를 사용한다.:
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_INVALLINEHANDLE
NDIS_STATUS_TAPI_INVALMEDIAMODE
NDIS_STATUS_TAPI_NODRIVER
NDIS_STATUS_TAPI_RESOURCEUNAVAIL
NDIS_STATUS_FAILURE

OID_TAPI_SET_DEV_CONFIG

이 OID 는 OID_TAPI_GET_DEV_CONFIG를 사용함으로써 앞어 얻은 구성으로부터 라인 장치에 일대일로 연관된 장치의 구성을 복구할 것을 미니포트에게 요청한다.

이 구조체의 내용은 미니포트의 라인과 장치 클래스에 특정적이다.

이 요청에 대한 지원은 의무적이다.

이 요청은 아래에 정의된 NDIS_TAPI_SET_DEV_CONFIG 구조체를 사용한다.: 


typedef struct _NDIS_TAPI_SET_DEV_CONFIG { 

    IN ULONG  ulRequestID; 

    IN ULONG  ulDeviceID; 

    IN ULONG  ulDeviceClassSize; 

    IN ULONG  ulDeviceClassOffset; 

    IN ULONG  ulDeviceConfigSize; 

    IN UCHAR  DeviceConfig[1]; 

} NDIS_TAPI_SET_DEV_CONFIG, *PNDIS_TAPI_SET_DEV_CONFIG;

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

ulRequestID
예약됨.

ulDeviceID
구성될 라인 장치를 지정한다. 이 값은 앞의 OID_TAPI_PROVIDER_INITIALIZE 요청에서 설정된다.

ulDeviceClassSize
복구될 장치의 구성을 위한 장치 클래스의 바이트 크기를 지정한다. 유효한 장치 클래스 스티링은 그것이 "라인" 장치에 적용될 때 OID_TAPI_GET_ID 요청을 위해서 지정된 이러한 것과 똑같다. (ulSelect 는 값 LINECALLSELECT_LINE를 가진다.)

ulDeviceClassOffset
복구될 장치의 구성을 위한 장치 클래스의 바이트 옵셋을 지정한다.

ulDeviceConfigSize
DeviceConfig에서 바이트 넘버를 지정한다. 이 값은 이미 앞의 OID_TAPI_GET_DEV_CONFIG 요청에서 리턴된 VAR_STRING 스트링에 있는 ulStringSize 멤버에 이미 리턴된다.

DeviceConfig
앞의 OID_TAPI_GET_DEV_CONFIG 요청에 대한 VAR_STRING 구조체의 가변 부분에서 리턴된 데이터를 지정한다.

이 요청은 아래에 정의된 NDIS_TAPI_SET_DEV_CONFIG 구조체를 사용한다.:
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_INVALDEVICECLASS
NDIS_STATUS_TAPI_INVALPARAM
NDIS_STATUS_TAPI_NODRIVER
NDIS_STATUS_TAPI_RESOURCEUNAVAIL
NDIS_STATUS_FAILURE

OID_TAPI_SET_MEDIA_MODE

이 OID는 그 호출에 대한 LINE_CALL_INFO 구조체에 저장된 것으로써 호출의 미디어 모드를 바꿀것을 미니포트에게 요청한다. LINE_CALL_INFO 의 선언에 대해서는 ndistapi.h 를 봐라.

이 요청에 대한 지원은 의무적이다.

이 요청은 아래에 정의된 NDIS_TAPI_SET_MEDIA_MODE 구조체를 사용한다.: 


typedef struct _NDIS_TAPI_SET_MEDIA_MODE { 

    IN ULONG      ulRequestID; 

    IN HDRV_CALL  hdCall; 

    IN ULONG      ulMediaMode; 

} NDIS_TAPI_SET_MEDIA_MODE, *PNDIS_TAPI_SET_MEDIA_MODE;

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

ulRequestID
예약됨.

hdCall
미디어 모드를 변화해야하는 호출에 대한 미니포트의 핸들을 지정한다.

ulMediaMode
하나 이상의 LINEMEDIAMODE_XXX 플래그 호출을 위한 새로운 미디어 모드(들)을 지정한다. 만약에 LINEMEDIAMODE_UNKNOWN 플래그가 설정되면, 다름 미디어 모드 플래그는 또한 설정될 수 있다. 그런 플래그들의 조합이 호출의 미디어 모드가 완전히 결정되는 것이 아니라, 가능한 미디어 모드들의 서브셋으로 narrowed 는 것을 지정한다.(애매??) 만약 LINEMEDIAMODE_UNKNOWN 플래그가 지워지면, 단지 싱글 미디어 모드가 지정될 수 있다.

MiniportSetInformation 함수는 아래중의 하나를 리턴할 수 있다.;
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_INVALCALLHANDLE
NDIS_STATUS_TAPI_INVALMEDIAMODE
NDIS_STATUS_TAPI_RESOURCEUNAVAIL
NDIS_STATUS_FAILURE

OID_TAPI_SET_STATUS_MESSAGES

이 OID는 NDISTAPI가 미니포트가 지정된 라인이나 그것의 주소들의 어떤것을 위한 상태 변화들에 연관된 이벤트들을 발생할 수 있는 통지 메시지들을 지정하는것을 허락할 것을 요청한다.

기본적으로, address-status 와 line-status 보고는(reporting)는 초기에 라인에 대해서 디스에이블이다.

이 요청에 대한 지원은 의무적이다.

이 요청은 아래에 정의된 NDIS_TAPI_SET_STATUS_MESSAGES 구조체를 사용한다.: 


typedef struct _NDIS_TAPI_SET_STATUS_MESSAGES { 

    IN ULONG      ulRequestID; 

    IN HDRV_LINE  hdLine; 

    IN ULONG      ulLineStates; 

    IN ULONG      ulAddressStates; 

} NDIS_TAPI_SET_STATUS_MESSAGES, *PNDIS_TAPI_SET_STATUS_MESSAGES;

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

ulRequestID
예약됨.

hdLine
라인장치에 대한 미니포트의 핸들을 지정한다.

ulLineStates
NDISTAPI에게 보내져야하는 메시지들을 위한 상태 변화들을 알리는 비트 배열을 지정한다. 이 파라미터는 LINEDEVSTATE 상수들을 사용한다. 세부적인 것은 ndistapi.h 을 봐라.

ulAddressStates
NDISTAPI에 적합한 통지들을 보내기 위해서 모니터해야하는 미니포트의 상태 변화들을 알리는 비트 배열을 지정한다. 이 값은 LINEADDRESSSTATE 플래그의 ORed 조합이다. 세부적인 것은 ndistapi.h 을 봐라.

이 요청은 아래에 정의된 NDIS_TAPI_SET_MEDIA_MODE 구조체를 사용한다.:
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_INVALLINEHANDLE
NDIS_STATUS_TAPI_INVALLINESTATE
NDIS_STATUS_TAPI_RESOURCEUNAVAIL
NDIS_STATUS_FAILURE

OID_TAPI_ACCEPT

이 OID 는 지정된 호출을 수락할 것을 미니포트에게 요청한다. 추가적으로, 그것은 미니포트가 지정된 사용자-to-사용자 정보를 호출 파티에게 보내는 것을 요청한다.

이 요청에 대한 지원은 추가적이다.

이 요청은 아래에 정의된 NDIS_TAPI_ACCEPT 구조체를 사용한다.: 


typedef struct _NDIS_TAPI_ACCEPT { 

    IN ULONG      ulRequestID; 

    IN HDRV_CALL  hdCall; 

    IN ULONG      ulUserUserInfoSize; 

    IN UCHAR      UserUserInfo[1]; 

} NDIS_TAPI_ACCEPT, *PNDIS_TAPI_ACCEPT;

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

ulRequestID
예약됨.

hdCall
수락될 호출에 대한 미니포트의 핸들을 지정한다. 드라이버는 LINE_EVENT_NEWCALL 알림으로 NdisMIndicateStatus 를 호출할 때 이 핸들을 설정한다.

ulUserUserInfoSize
UserUserInfo에 있는 사용자-to-사용자 정보의 바이트 크기를 지정한다. 만약 이 멤버가 0이면, 미니포트는 다음 멤버를 무시해야 한다.

UserUserInfo
호출-수락 연산의 부분으로부터 리모트 파티에 보내질 사용자-to-사용자 정보를 포함하는 스트링을 지정한다. 사용자-to-사용자 정보는 만약 아래의 네트워크로부터 지원된다면 보내진다(OID_TAPI_GET_DEV_CAPS 를 봐라).

MiniportSetInformation 함수는 아래중의 하나를 리턴할 수 있다.;
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_INVALCALLHANDLE
NDIS_STATUS_TAPI_INVALCALLSTATE
NDIS_STATUS_TAPI_RESOURCEUNAVAIL
NDIS_STATUS_TAPI_USERUSERINFOTOOBIG
NDIS_STATUS_FAILURE

OID_TAPI_DIAL

이 OID는 지정도 호출상에 있는 지정된 번호에 다이얼할 것을 미니포트에게 요청한다.

이 요청에 대한 지원은 추가적이다.

이 요청은 아래에 정의된 NDIS_TAPI_DIAL 구조체를 사용한다.: 


typedef struct _NDIS_TAPI_DIAL { 

    IN ULONG      ulRequestID; 

    IN HDRV_CALL  hdCall; 

    IN ULONG      ulDestAddressSize; 

    IN CHAR       szDestAddress[1]; 

} NDIS_TAPI_DIAL, *PNDIS_TAPI_DIAL;

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

ulRequestID
예약됨.

hdCall
다이얼해야할 호출에 대한 미니포트의 핸들을 지정한다. 이 핸들은 앞의 OID_TAPI_MAKE_CALL 요청에서 설정된다.

ulDestAddressSize
다음 멤버에 있는 주소의 바이트 크기를 지정한다.

szDestAddress
표준 dialable 넘버 포멧에서 다이얼될 목적지를 지정한다.

MiniportSetInformation 함수는 아래중의 하나를 리턴할 수 있다.;
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_INVALCALLHANDLE
NDIS_STATUS_TAPI_INVALADDRESS
NDIS_STATUS_TAPI_INVALCALLSTATE
NDIS_STATUS_TAPI_ADDRESSBLOCKED
NDIS_STATUS_TAPI_DIALBILLING
NDIS_STATUS_TAPI_DIALQUIET
NDIS_STATUS_TAPI_DIALDIALTONE
NDIS_STATUS_TAPI_DIALPROMPT
NDIS_STATUS_TAPI_OPERATIONUNAVAIL
NDIS_STATUS_TAPI_RESOURCEUNAVAIL
NDIS_STATUS_FAILURE

OID_TAPI_SECURE_CALL

이 OID는 미니포트에게 호출의 미디어 스트림에 영향을 끼칠수 있는 인터럽션 혹은 충돌로부터의 특정한 호출을 보호하도록 요청한다.

이 요청에대한 지원은 추가적인것이다.

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


typedef struct _NDIS_TAPI_SECURE_CALL { 

    IN ULONG      ulRequestID; 

    IN HDRV_CALL  hdCall; 

} NDIS_TAPI_SECURE_CALL, *PNDIS_TAPI_SECURE_CALL;

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

ulRequestID
예약됨.

hdCall
보호될 호출에대한 미니포트의 핸들을 지정한다.

MiniportSetInformation함수는 다음중 하나를 리턴할수 있다.:
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_INVALCALLHANDLE
NDIS_STATUS_TAPI_INVALCALLSTATE
NDIS_STATUS_TAPI_OPERATIONUNAVAIL
NDIS_STATUS_TAPI_RESOURCEUNAVAIL
NDIS_STATUS_FAILURE

OID_TAPI_SELECT_EXT_VERSION

이 OID는 미니포트가 인디케이트된 라인 장치를 위해 인디케이트된 확장 버전을 선택하도록 요구한다. 라인에서 계속적인 요구들은 선택된 확장 버전에 따라 운영한다.

이러한 요구를 위한 지원은 선택적이다.

이러한 요구는 다음과 같이 정의된, NDIS_TAPI_SELECT_EXT_VERSION 구조체를 사용한다. 


typedef struct _NDIS_TAPI_SELECT_EXT_VERSION { 

    IN ULONG      ulRequestID; 

    IN HDRV_LINE  hdLine; 

    IN ULONG      ulExtVersion; 

} NDIS_TAPI_SELECT_EXT_VERSION, *PNDIS_TAPI_SELECT_EXT_VERSION;

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

ulRequestID
예약

hdLine
확장 버전이 선택된 라인에 대한 핸들을 지정한다.

ulExtVersion
선택된 확장 버전을 지정한다. 가장 큰 2 바이트는 메이저 버전 넘버를 지정하고 작은 의미있는 두 바이트는 마이너 버전 넘버를 지정한다. 0은 미니포트가 현 선택을 취소해야 한다는 것을 가리킨다.

이 버전은 선행 OID_TAPI_NEGOTIATE_EXT_VERSION 요구에서 협상되어진다.

MiniportSetInformation 함수는 다음과 같은 하나를 리턴할 수 있다.
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_INCOMPATIBLEEXTVERSION
NDIS_STATUS_TAPI_OPERATIONUNAVAIL
NDIS_STATUS_TAPI_RESOURCEUNAVAIL
NDIS_STATUS_FAILURE

OID_TAPI_SEND_USER_USER_INFO

이 OID는 미니포트에게 특정 콜에서 리모트 파티에게 사용자 대 사용자 정보를 보내도록 요구한다.

이러한 요구를 위한 지원은 선택적이다.

이러한 요구는 다음과 같이 정의된 NDIS_TAPI_SEND_USER_USER_INFO 구조체를 사용한다. 


typedef struct _NDIS_TAPI_SEND_USER_USER_INFO { 

    IN ULONG      ulRequestID; 

    IN HDRV_CALL  hdCall; 

    IN ULONG      ulUserUserInfoSize; 

    IN UCHAR      UserUserInfo[1]; 

} NDIS_TAPI_SEND_USER_USER_INFO, *PNDIS_TAPI_SEND_USER_USER_INFO;

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

ulRequestID
예약

hdCall
user-to-user 정보를 보내는 콜에 대한 미니포트의 핸들을 지정한다.

UserUserInfo
콜 수락 연산의 부분으로 리모트 파티로 보내진 사용자대사용자 정보를 포함하는 문자열을 지정한다. 사용자대사용자 정보는 만약 아래 네트워크에 의해 지원된다면, 보내어진다. (OID_TAPI_GET_DEV_CAPS를 봐라)

MiniportSetInformation 함수는 다음과 같은 하나를 리턴할 수 있다.
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_INVALCALLHANDLE
NDIS_STATUS_TAPI_INVALCALLSTATE
NDIS_STATUS_TAPI_USERUSERINFOTOOBIG
NDIS_STATUS_TAPI_OPERATIONUNAVAIL
NDIS_STATUS_TAPI_RESOURCEUNAVAIL
NDIS_STATUS_FAILURE