9.1 TAPI 쿼리 정보 요청들

구조체 정의에 있는 "OUT" 접두어에 의해서 표시되는 연관된 구조체에 있는 하나 이상의 멤버들에 있는 셋-정보 요청들과는 다르게 쿼리정보 요청들은 요청의 발기인(initiator)에게 아래의 미니포트가 리턴해야하는 정보를 위해서 예약된다. WAN NIC 드라이버들은 읽기-전용으로 "IN" 으로 접두어된 구조체 멤버들을 다뤄야한다.

쿼리-정보 요청들에 사용된 모든 구조체들의 첫번째 멤버인 ulRequestID는 미래 사용을 위해서 예약되어있다. 미니포트 드라이버는 이 멤버를 무시해야 한다.

OID_TAPI_GET_ADDRESS_CAPS

이 OID 는 WAN NIC 드라이버에게 그것의 텔레포니 능력들에 관해서 지정된 라인상에 있는 지정된 주소를 위해서 정보를 리턴할 것을 요청한다.

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

이 요청은 지정된 주소의 텔레포니 능력들을 쿼리하기 위해서 아래에 정의된 NDIS_TAPI_GET_ADDRESS_CAPS 구조체를 사용한다.: 




typedef struct _NDIS_TAPI_GET_ADDRESS_CAPS { 

    IN ULONG               ulRequestID; 

    IN ULONG               ulDeviceID; 

    IN ULONG               ulAddressID; 

    IN ULONG               ulExtVersion; 

    OUT LINE_ADDRESS_CAPS  LineAddressCaps; 

} NDIS_TAPI_GET_ADDRESS_CAPS, *PNDIS_TAPI_GET_ADDRESS_CAPS;

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

ulRequestID
예약됨.

ulDeviceID
링크 또는 쿼리될 데이터 채널을 지정한다. 이것은 앞의 OID_TAPI_GET_ID 요청으로 설정된다.

ulAddressID
리턴되어야할 능력들을 위해서 주어진 링크상에 있는 주소를 지정한다. 이 멤버의 값은 이 요청이 만들어질때 NDISTAPI 에 의해서 입증되지(validated) 않는다.

ulExtVersion
사용될 미니포트-특정 확장(extensions)의 버전 번호를 지정한다. 만약 어떠한 장치-특정 확장들이 사용되지 않는다면, 이 멤버는 0이다. 그렇지 않으면, 높은-순서(high-order) 바이트들은 메이저(major) 버전 넘버를 포함하고, 낮은-순서(low-order) 바이트들은 마이너(minor) 버전 넘버를 포함한다. 이 멤버의 값은 이 요청이 만들어질때 NDISTAPI 에 의해서 입증되지 않는다.

LineAddressCaps
타입 LINE_ADDRESS_CAPS의 가변-크기(variable-size) 구조체의 베이스 가상 주소를 지정한다. 자세한 것은 ndistapi.h 를 봐라.

이 구조체는 적어도 예약된 sizeof(LINE_ADDRESS_CAPS) 바이트 이다.

이 요청의 성공적인 완료때, 미니포트는 이 구조체를 주소 능력 정보로 채운다.

MiniportQueryInformation 함수는 아래의 하나를 리턴할 수 있다.:
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_INCOMPATIBLEEXTVERSION
NDIS_STATUS_TAPI_INVALADDRESSID
NDIS_STATUS_TAPI_NODRIVER
NDIS_STATUS_FAILURE

OID_TAPI_GET_ADDRESS_ID

이 OID 요청는 WAN NIC 에게 지정된 라인상에 있는 다른 포멧에 주소와 연관된 주소 ID를 리턴할것을 요청한다.

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

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




typedef struct _NDIS_TAPI_GET_ADDRESS_ID { 

    IN ULONG      ulRequestID; 

    IN HDRV_LINE  hdLine; 

    OUT ULONG     ulAddressID; 

    IN ULONG      ulAddressMode; 

    IN ULONG      ulAddressSize; 

    IN CHAR       szAddress[1]; 

} NDIS_TAPI_GET_ADDRESS_ID, *PNDIS_TAPI_GET_ADDRESS_ID;

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

ulRequestID
예약됨.

hdLine
회수되어야 할 주소 ID를 위해서 라인에 대한 미니포트의 핸들을 지정한다. 이것은 앞의 OID_TAPI_OPEN 요청으로 설정된다.

ulAddressID
요청된 주소 ID 를 지정한다. 미니포트는 이 요청을 성공적으로 완성하기 위해서 szAddress 와 일치하는 주소 ID 로 이 멤버에 채운다.

ulAddressMode
szAddress 에 포함된 주소의 주소 모드를 지정한다. 이 멤버는 단지 아래의 LINEADDRESSMODE 플래그 설정 일수 있다.:

LINEADDRESSMODE_DIALABLEADDR

ulAddressSize
szAddress 에 있는 주소의 바이트 크기를 지정한다.

szAddress
라인 장치에 할당된 주소를 포함하는 가변-크기 구조체의 가상 주소를 지정한다. 주소의 포멧은 ulAddressMode 멤버에 의해서 결정된다. 만약 그것이 LINEADDRESSMODE_DIALABLEADDR 이면, szAddress 는 공통(common) 디스에이블 멤버 포멧을 사용하고 0-종료된다.

MiniportQueryInformation 함수는 아래중의 하나를 리턴할 수 있다.:
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_INVALLINEHANDLE
NDIS_STATUS_TAPI_INVALADDRESS
NDIS_STATUS_TAPI_RESOURCEUNAVAIL
NDIS_STATUS_FAILURE

OID_TAPI_GET_ADDRESS_STATUS

이 OID는 미니포트에게 지정된 주소의 현재상태를 리턴할 것을 요청한다.

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

이 요청은 지정된 주소의 현재상태를 쿼리하기 위해서 아래에 정의된 NDIS_TAPI_GET_ADDRESS_ID 구조체를 사용한다.: 


typedef struct _NDIS_TAPI_GET_ADDRESS_STATUS { 

    IN ULONG                 ulRequestID; 

    IN HDRV_LINE             hdLine; 

    IN ULONG                 ulAddressID; 

    OUT LINE_ADDRESS_STATUS  LineAddressStatus; 

} NDIS_TAPI_GET_ADDRESS_STATUS, *PNDIS_TAPI_GET_ADDRESS_STATUS;

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

ulRequestID
예약됨.

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

ulAddressID
주어진 오픈 장치상에 있는 주소를 지정한다. 이것은 리턴되어야할 상태에 대한 주소이다. 이 멤버의 값은 이 요청이 만들어질때 NDISTAPI 에 의해서 입증되지(validated) 않는다.

LineAddressStatus
타입 LINE_ADDRESS_STATUS의 가변-크기 구조체의 가상 주소를 지정한다. 세부적인것은 ndistapi.h 을 봐라.

미니포트는 이 요청을 성공적으로 완성하기 위해서 주소 상태 정보로 이 구조체를 채운다.

LineAddressStatus 멤버는 적어도 예약된 sizeof(LINE_ADDRESS_STATUS) 바이트를 가진다.

MiniportQueryInformation 함수는 아래중의 하나를 리턴할 수 있다.:
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_INVALLINEHANDLE
NDIS_STATUS_TAPI_INVALADDRESSID
NDIS_STATUS_TAPI_RESOURCEUNAVAIL
NDIS_STATUS_FAILURE

OID_TAPI_GET_CALL_ADDRESS_ID

이 OID 는 지정된 호출에 대한 주소를 리턴할 것을 미니포트에게 요청한다.

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

이 구조체는 아래에 정의된 NDIS_TAPI_GET_CALL_ADDRESS_ID 구조체를 사용한다.: 


typedef struct _NDIS_TAPI_GET_CALL_ADDRESS_ID { 

    IN ULONG      ulRequestID; 

    IN HDRV_CALL  hdCall; 

    OUT ULONG     ulAddressID; 

} NDIS_TAPI_GET_CALL_ADDRESS_ID, *PNDIS_TAPI_GET_CALL_ADDRESS_ID;

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

ulRequestID
예약됨.

hdCall
회수되어야할 ID를 위해서 호출에 대한 미니포트의 핸들을 리턴한다. 이 핸들은 앞의 OID_TAPI_MAKE_CALL 요청에서 또는 미니포트가 들어오는 호출을 제출하기 위해서 NdisMIndicateStatus 를 호출했을때 설정된다.

ulAddressID
주소 ID를 지정한다. 미니포트는 이 요청을 성공적을 완성하기 위해서 hdCall 에 대한 일치하는 주소 ID로 이 멤버를 채운다.
MiniportQueryInformation 함수는 아래중의 하나를 리턴할 수 있다.:
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_RESOURCEUNAVAIL
NDIS_STATUS_FAILURE

OID_TAPI_GET_CALL_INFO

이 OID는 미니포트에게 지정된 호출에 대한 세부 정보를 리턴할 것을 요청한다.

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

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


typedef struct _NDIS_TAPI_GET_CALL_INFO { 

    IN ULONG            ulRequestID; 

    IN HDRV_CALL        hdCall; 

    OUT LINE_CALL_INFO  LineCallInfo; 

} NDIS_TAPI_GET_CALL_INFO, *PNDIS_TAPI_GET_CALL_INFO;

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

ulRequestID
예약됨.

hdCall
정보를 리턴해야하는 호출에 대한 미니포트의 핸들을 지정한다.

LineCallInfo
타입 LINE_CALL_INFO의 가상 주소 가변-크기 데이터 구조체를 지정한다. 세부적인것은 ndistapi.h 을 봐라.

미니포트는 이 요청을 성공적으로 완성하기 위해서 호출-연관된 정보로 이 구조체를 채운다.

LineCallInfo 에 구조체는 적어도 예약된 sizeof(LINE_CALL_INFO) 바이트를 가진다.

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

OID_TAPI_GET_CALL_STATUS

이 OID는 지정된 호출의 현재 상태를 리턴할 것을 미니포트에게 요청한다.

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

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


typedef struct _NDIS_TAPI_GET_CALL_STATUS { 

    IN ULONG              ulRequestID; 

    IN HDRV_CALL          hdCall; 

    OUT LINE_CALL_STATUS  LineCallStatus; 

} NDIS_TAPI_GET_CALL_STATUS, *PNDIS_TAPI_GET_CALL_STATUS;

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

ulRequestID
예약됨.

hdCall
리턴되어야 할 현재상태를 위해서 호출에 대한 미니포트의 핸들을 지정한다.

LineCallStatus
타입 LINE_CALL_STATUS의 가변-크기 구조체의 가상주소를 지정한다. 세부적인 것은 ndistapi.h 을 봐라.

미니포트는 이 요청을 성공적으로 완성하기 위해서 호출 상태로 이 구조체를 채운다.

LineCallStatus 에서 구조체는 적어도 예약된 sizeof(LINE_CALL_STATUS) 바이트를 가진다.

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

OID_TAPI_GET_DEV_CAPS

이 OID는 지정된 라인 장치의 텔레포니 능력들을 리턴할것을 미니포트에게 요청한다. 리턴된 정보는 주어진 라인 장치에 대해서 모든 주소들에게 유효하다.

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

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


typedef struct _NDIS_TAPI_GET_DEV_CAPS { 

    IN ULONG           ulRequestID; 

    IN ULONG           ulDeviceID; 

    IN ULONG           ulExtVersion; 

    OUT LINE_DEV_CAPS  LineDevCaps; 

} NDIS_TAPI_GET_DEV_CAPS, *PNDIS_TAPI_GET_DEV_CAPS;

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

ulRequestID
예약됨.

ulDeviceID
요구될 링크 또는 데이터 채널을 지정한다. 이것은 앞의 OID_TAPI_GET_ID 요청에서 설정된다.

ulExtVersion
만약 있다면, 협상된 확장 버전 넘버를 지정한다.

이 값은 OID_TAPI_NEGOTIATE_EXT_VERSION 요청을 통해서 이 장치를 위해서 이미 협상되어있다. 이 멤버의 값은 이 요청이 만들어질때 입증되지 않는다.

LineDevCaps
타입 LINE_DEV_CAPS 의 가변-크기 구조체의 가상주소를 지정한다. 세부적인 것은 ndistapi.h 을 봐라.

NIC 드라이버는 이 요청을 성공적으로 완성하기 위해서 라인 능력 정보로 이 구조체를 채운다.

LineDevCaps 에서 구조체는 적어도 예약된 sizeof(LINE_DEV_CAPS) 바이트를 가진다.

LINE_DEV_CAPS 의 dwProviderInfoOffset 멤버에 있는 지원된 제공자(provider) 정보는 아래의 포멧을 가져야한다.: 

MediaName\0ProviderName\0 

where 

MediaName 은 ISDN, SW56, FrameRelay, 기타 등등, 적합한 것으로

and 

ProviderName 은 만약 있다면, 장치의 제조업자(manufacturer)의 이름과 장치의 유일한 이름이다.



예를들면, SomeIHV Inc. 로부터 ISDN 장치의 드라이버는 스트링 "ISDN\0SomeIHV\0" 에 대한 포인터로 dwProviderInfoOffset 멤버를 설정해야한다.

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

OID_TAPI_GET_DEV_CONFIG

이 OID는 미니포트에게 특정한 라인에 일대일(one-to-one)로 연관된 장치의 현재 구성을 리턴할 것을 요청한다.

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

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


typedef struct _NDIS_TAPI_GET_DEV_CONFIG { 

    IN ULONG        ulRequestID; 

    IN ULONG        ulDeviceID; 

    IN ULONG        ulDeviceClassSize; 

    IN ULONG        ulDeviceClassOffset; 

    OUT VAR_STRING  DeviceConfig; 

} NDIS_TAPI_GET_DEV_CONFIG, *PNDIS_TAPI_GET_DEV_CONFIG;

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

ulRequestID
예약됨.

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

ulDeviceClassSize
장치-클래스 스트링에 있는 바이트 수를 지정한다.

ulDeviceClassOffset
구성이 요구되는 장치의 클래스를 지정하는 카운트된 가변-크기인, 0-종료까지 바이트에서 옵셋을 지정한다. 유효한 장치 클래스 스티링은 그것이 "라인" 장치에 적용될 때 OID_TAPI_GET_ID 요청을 위해서 지정된 이러한 것과 똑같다. (ulSelect 는 값 LINECALLSELECT_LINE를 가진다.)

DeviceConfig
연관된 장치를 위한 장치 구성 정보를 포함하기 위해서 타입 VAR_STRING 의 구조체의 가상 주소를 지정한다.

VAR_STRING 구조체의 ulStringFormat 멤버는 STRINGFORMAT_BINARY에 설정되어야 한다.

미니포트는 이 요청을 성공적으로 완성하기 위해서 장치 구성 정보로 이 구조체를 채운다.

일반적으로, NDIS_TAPI_GET_DEV_CONFIG 구조체의 내용은(contents) NIC 드라이버의 라인과 장치 클래스에 특정적이다.

MiniportQueryInformation 함수는 아래중의 하나를 리턴할 수 있다.:
NDIS_STATUS_SUCCESS
NNDIS_STATUS_TAPI_INVALDEVICECLASS
NDIS_STATUS_TAPI_STRUCTURETOOSMALL
NDIS_STATUS_TAPI_NODRIVER
NDIS_STATUS_TAPI_RESOURCEUNAVAIL
NDIS_STATUS_FAILURE

OID_TAPI_GET_ID

이 OID는 선택된 라인, 주소, 또는 호출과 연관된 지정된 장치 클래스에 대한 장치를 리턴할 것을 미니포트에게 요청한다.

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

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


typedef struct _NDIS_TAPI_GET_ID { 

    IN ULONG        ulRequestID; 

    IN HDRV_LINE    hdLine; 

    IN ULONG        ulAddressID; 

    IN HDRV_CALL    hdCall; 

    IN ULONG        ulSelect; 

    IN ULONG        ulDeviceClassSize; 

    IN ULONG        ulDeviceClassOffset; 

    OUT VAR_STRING  DeviceID; 

} NDIS_TAPI_GET_ID, *PNDIS_TAPI_GET_ID;

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

ulRequestID
예약됨.

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

ulAddressID
주어진 오픈 라인 장치상에 있는 주소를 지정한다. 이 멤버의 값은 이 요청이 만들어질때 NDISTAPI 에 의해서 입증되지(validated) 않는다.

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

ulSelect
장치 ID가 라인, 주소 또는 아래중의 하나로써 싱들 호출인지를 지정한다.:

LINECALLSELECT_LINE
지정된 라인 장치를 선택한다. hdLine 멤버는 유효한 라인 핸들을 포함해야 한다; hdCall 와 ulAddressID는 사용되지 않는다.

LINECALLSELECT_ADDRESS
라인상에 있는 지정된 주소를 선택한다. hdLine 와 ulAddressID 모두 유효해야한다.; hdCall 는 사용된지 않는다.

LINECALLSELECT_CALL
지정된 호출을 선택한다. hdCall 멤버는 입증되어야 한다.; hdLine 와 ulAddressID는 사용되지 않는다.

ulDeviceClassSize
리턴되어야 하는 구성을 위한 장치의 장치 클래스를 지정하는 가변-크기 스트링인 0-종료되는 바이트 크기를 지정한다.

ulDeviceClassOffset
장치-클래스 스트링에 대한 바이트 옵셋을 지정한다.

DeviceID
리턴되어야 하는 장치 ID 에 있는 타입 VAR_STRING 의 데이트 구조체의 가상 주소를 지정한다.

미니포트는 이 요청을 성공적으로 완성하기 위해서 장치 ID로 이 구조체를 채운다.

현재, WAN NIC 드라이버에 의해서 지원되어야 하는 이 요청들의 2가지 타입이 있다.: 


1. IN DeviceClass = "ndis" // 대소문자 구분 안함(case insensitive)

IN ulSelect = LINECALLSELECT_CALL

IN hdCall = ActiveCallHandle

OUT DeviceID = ConnectionWrapperID 



DeviceID 는 링크를 설립하기 위해서 처음의 NDIS_STATUS_WAN_LINE_UP 알림에 대한 NDIS_MAC_LINE_UP 구조체에서 NDISWAN 에 의해서 리턴된 NdisLinkContext 핸들에 설정되어야 한다.



미니포트는 이 DeviceID 값을 지원하기 위해서 이 요청으로부터 리턴되기 전에, 링크를 설립하기 위해서(또는 라인상에 있는 데이터 채널을 오픈하기 위해서) 처음의 라인-업 알림을 만들어야 한다.





2. IN DeviceClass = "tapi/line"

IN ulSelect = LINECALLSELECT_LINE

IN hdLine = OpenLineHandle

OUT DeviceID = ulDeviceID 



DeviceID 는 라인 핸들과 연관된 미니포트-결정된(miniport-determined) DeviceID 에 설정될 것이다.

MiniportQueryInformation 함수는 아래중의 하나를 리턴할 수 있다.:
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_INVALLINEHANDLE
NDIS_STATUS_TAPI_INVALADDRESSID
NDIS_STATUS_TAPI_INVALCALLHANDLE
NDIS_STATUS_TAPI_NODEVICE
NDIS_STATUS_TAPI_RESOURCEUNAVAIL
NDIS_STATUS_FAILURE

OID_TAPI_GET_LINE_DEV_STATUS

이 OID는 지정된 오픈 라인 장치에 대한 현재상태를 리턴할 것을 미니포트에게 요청한다. 리턴된 정보는 라인상에 있는 모든 주소들에게 전역이다(global).

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

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


typedef struct _NDIS_TAPI_GET_LINE_DEV_STATUS { 

    IN ULONG             ulRequestID; 

    IN HDRV_LINE         hdLine; 

    OUT LINE_DEV_STATUS  LineDevStatus; 

} NDIS_TAPI_GET_LINE_DEV_STATUS, *PNDIS_TAPI_GET_LINE_DEV_STATUS;

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

ulRequestID
예약됨.

hdLine
요구되는 장치에 대한 미니포트의 핸들을 지정한다.

LineDevStatus
타입 LINE_DEV_STATUS의 가변-크기 구조체를 지정한다.

Specifies a variable-sized structure of type LINE_DEV_STATUS. 세부적인 것은 ndistapi.h 을 봐라.

미니포트는 이 요청을 완성하기 위해서 라인의 현재 장치 상태로 이 구조체로 채울 것이다.

LineDevStatus
LineDevStatus 에서 구조체는 적어도 예약된 sizeof(LINE_DEV_STATUS) 바이트를 가진다.

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

OID_TAPI_MAKE_CALL

이 OID는 지정된 목적지 주소에 지정된 라인상에 호출을 놓을 것을 미니포트에게 요청한다. 추가적으로, 만약 미니포트가 기본 호출-설정(call-setup) 파라미터들보다 어떤것을 사용한다면, 추가적인 호출 파라미터들은 지정될 수 있다.

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

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


typedef struct _NDIS_TAPI_MAKE_CALL { 

    IN ULONG             ulRequestID; 

    IN HDRV_LINE         hdLine; 

    IN HTAPI_CALL        htCall; 

    OUT HDRV_CALL        hdCall; 

    IN ULONG             ulDestAddressSize; 

    IN ULONG             ulDestAddressOffset; 

    IN BOOLEAN           bUseDefaultLineCallParams; 

    IN LINE_CALL_PARAMS  LineCallParams; 

} NDIS_TAPI_MAKE_CALL, *PNDIS_TAPI_MAKE_CALL;

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

ulRequestID
예약됨.

hdLine
발생되는 새로운 호출상에 있는 라인에 대한 미니포트의 핸들을 지정한다.

htCall
호출에 대한 NDISTAPI의 핸들을 지정한다.

미니포트는 다음의 통지들에서 사용을 위해서, 특별히 링크나 데이터 채널을 설립하기 위해서 처음의 NDIS_MAC_LINE_UP 통지들, 이 핸들을 저장한다.

hdCall
호출에 대한 미니포트의 핸들을 지정한다. 미니포트는 이 요청이 성공적으로 완성하기전에 호출에 대한 그것의 핸들로 이 멤버를 채워야한다. 이 핸들은 만약 미니포트가 에러 상태를 리턴한다면 무시된다.

ulDestAddressSize
목적지 주소를 포함하는 ulDestAddressOffset 에서 가변-크기 버퍼의 바이트 크기를 지정한다.

이 멤버는 항상 자동적으로 미리정의된 번호에 연결하는 핫 폰(hot phone)같은 undialed 주소들을 위해서 또는 또는 다이얼링이 OID_TAPI_DIAL 요청이 다음에 행해질 때 0이 될 수 있다.

ulDestAddressOffset
이 구조체의 시작부터 목적지 주소까지 바이트 옵셋을 지정한다. 이 목적지 주소는 표준 dialable 넘버 포맷이다. 만약 ulDestAddressSize 가 0이면, 이 멤버는 0 일 수 있다. 만약 다이얼링이 OID_TAPI_DIAL 요청이 다음에 행해질 것이라면, 드라이버는 이 요청을 받는 즉시 가능한 호출 출현(appearance)을 할당해야하고, 다이얼이 시작할때까지 다이얼톤 상태를 유지해야한다.

반대의(inverse) 멀티플렉싱 능력들을 가지는 NIC들의 드라이버들은 어플리케이션이 한번에 많은 주소들을 지정하는 것을 허락할 수 있다.

bUseDefaultLineCallParams
미니포트가 기본 호출-설정 파라미터들을 사용할 것인지 또는 호출 만들때 LineCallParams 에 있는 지정된 파라미터들을 사용할 것인지를 지정한다. 만약 이 멤버가 FALSE 이면, 드라이버는 LineCallParams를 무시해야 한다.

LineCallParams
이 멤버에 있는 LINE_CALL_PARAMS 구조체는 어떻게 호출이 설정될 수 있는지를 지정한다. 그것은 호출의 전달자(bearer) 모드, 데이터 비율(rate), 예기된 미디어 모드, origination address, 호출 ID 정보의 블러킹, 그리고 다이얼링 파라미터들과 같은 엘러먼트(elements)를 선택한다. 세부적인 것은 ndistapi.h 을 봐라.

앞의 오픈된 라인상에 텔레포니 호출을 놓기 위해서, 어플리케이션은 지정한 목적지 주소와 어떻게 텔레포니 호출이 설정될 수 있는지를 지정하는 정보를 지정한다. NDISWAN 드라이버는 이 주소와 정보를 수신하고, 주어진 라인상에 호출을 놓기 위해서 WAN 미니포트에게 NDIS_TAPI_MAKE_CALL 구조체에 그들을 아래로 통과시킨다. 예를들면, 아래의 X.25 네트워크를 위해서, X.25 WAN 미니포트는 NDIS_TAPI_MAKE_CALL로부터 아래의 정보에 접근할 수 있다.:

  • ulDestAddressOffset 멤버로부터 X.25 네트워크 주소
  • LineCallParams 멤버에서 호출 파라미터들을 사용할 것을 X.25 WAN 미니포트에게 알리기 위해서 bUseDefaultLineCallParams 멤버로부터 TRUE
  • LineCallParams 멤버의 ulDevSpecificOffset 멤버로부터 X.25-facilities 정보
  • LineCallParams 멤버의 ulUserUserInfoOffset 멤버로부터 X.25-user 정보

MiniportQueryInformation 함수는 아래중의 하나를 리턴할 수 있다.:
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_ADDRESSBLOCKED
NDIS_STATUS_TAPI_BEARERMODEUNAVAIL
NDIS_STATUS_TAPI_CALLUNAVAIL
NDIS_STATUS_TAPI_DIALBILLING
NDIS_STATUS_TAPI_DIALQUIET
NDIS_STATUS_TAPI_DIALDIALTONE
NDIS_STATUS_TAPI_DIALPROMPT
NDIS_STATUS_TAPI_INUSE
NDIS_STATUS_TAPI_INVALBEARERMODE
NDIS_STATUS_TAPI_INVALMEDIAMODE
NDIS_STATUS_TAPI_INVALLINESTATE
NDIS_STATUS_TAPI_INVALRATE
NDIS_STATUS_TAPI_INVALLINEHANDLE
NDIS_STATUS_TAPI_INVALADDRESS
NDIS_STATUS_TAPI_INVALADDRESSID
NDIS_STATUS_TAPI_INVALCALLPARAMS
NDIS_STATUS_TAPI_RESOURCEUNAVAIL
NDIS_STATUS_TAPI_RATEUNAVAIL
NDIS_STATUS_TAPI_USERUSERINFOTOOBIG
NDIS_STATUS_FAILURE

OID_TAPI_OPEN

이 OID는 주어진 장치 ID 에 의해서 나타난(designated) 라인 장치를 열것을 미니포트에게 요청하고 장치에 대한 NIC 드라이버의 핸들을 리턴한다.

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

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


typedef struct _NDIS_TAPI_OPEN { 

    IN ULONG       ulRequestID; 

    IN ULONG       ulDeviceID; 

    IN HTAPI_LINE  htLine; 

    OUT HDRV_LINE  hdLine; 

} NDIS_TAPI_OPEN, *PNDIS_TAPI_OPEN;

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

ulRequestID
예약됨.

ulDeviceID
요구되는 라인 장츠를 지정한다. 이것은 앞의 OID_TAPI_PROVIDER_INITIALIZE 요청에서 설정된다.

htLine
라인을 식별하기 위해서 LINE_EVENT 콜백 프로시져에 다음의 호출에 사용되기 위한 라인 장치에 대한 NDISTAPI의 핸들을 지정한다.

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

NIC 드라이버는 이 요청을 성공적으로 완성하기 위해서 라인 장치에 대한 그것의 핸들로 이 위치를 채운다. 만약 미니포트가 이 요청을 에러 상태로 완성한다면 이 핸들은 무시된다.

MiniportQueryInformation 함수는 아래중의 하나를 리턴할 수 있다.:
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_ALLOCATED
NDIS_STATUS_TAPI_INVALMEDIAMODE
NDIS_STATUS_FAILURE

미니포트는 LINE_EVENT 구조체를 사용함으로써 다음의 NDIS_TAPI_EVENT 통지들에 사용을 위해서 NDISTAPI 에 의해서 제공된 장치를 위한 htLine 핸들을 유지한다.

OID_TAPI_PROVIDER_INITIALIZE

이 OID 는 미니포트가 TAPI 제공자로서 그 자체를 초기화할 것을 요청한다. 드라이버는 TAPI로부터 들어오는 요청들을 더듬기(track)위해서 사용하는 내부의 상태가 무엇이든지 설정해야한다.

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

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


typedef struct _NDIS_TAPI_PROVIDER_INITIALIZE { 

    IN ULONG   ulRequestID; 

    IN ULONG   ulDeviceIDBase; 

    OUT ULONG  ulNumLineDevs; 

    OUT ULONG  ulProviderID; 

} NDIS_TAPI_PROVIDER_INITIALIZE, *PNDIS_TAPI_PROVIDER_INITIALIZE;

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

ulRequestID
예약됨.

ulDeviceIDBase
미니포트에 의해서 지원된 라인 장치들에 대한 최하위(lowest) 장치 ID를 지정한다. 이 요청 다음에, 드라이버는 0-기초된 라인 장치 식별자 값으로써 이 값을 사용한다. 그것은, 만약 ulNumLineDevs 이 1보다 크다면, ulDeviceID 값은 차례로 첫번째 라인에 대한 이 값을 포함하는 OID_TAPI_OPEN 과 같은 요청에 통과시키고, 이 값은 두번째 라인을 위해서 하나를 더하고, 등등

ulNumLineDevs
이 요청을 성공적을 완성하기 위해서 미니포트에 의해서 지원된 라인 장치들의 수를 지정하다.

ulProviderID
만약 요청이 성공적으로 완성된다면, WAN NIC 드라이버를 위한 ID를 지정한다. 이 값은 TAPI를 지원하는 WAN 드라이버들의 집합내에서 유일해야한다.; MiniportInitialize 함수에 통과된 NdisMiniportContext 핸들은 보증된 유일한 값을 제공하기 위해서 사용될 수 있다.

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

OID_TAPI_CONFIG_DIALOG

이 OID 는 지정된 장치를 구성하기 위해서 로드되고 호출될 수 있는 사용자-모드 동적-링크 라이브러리의 이름을 리턴할 것을 미니포트에게 요청한다.

그런 구성 DLL은 아래의 함수를 이름순으로 익스포트 한다.:

LONG
WINAPI
ConfigDialog(
IN HWND hwndOwner,
IN ULONG ulDeviceID,
IN LPCSTR lpszDeviceClass
);

이 요청에 대한 지원은 추가적이다. 이 요청은 RAS에 의해서 만들어지지 않는다.

아래에 정의된 NDIS_TAPI_CONFIG_DIALOG 구조체는 지정된 장치를 구성하기 위해서 호출될 수 있는 사용자-모드 동적 링크 라이브러리의 이름을 회수하기 위해서 이 OID를 가지고 사용된다. 


typedef struct _NDIS_TAPI_CONFIG_DIALOG { 

    IN ULONG  ulRequestID; 

    IN ULONG  ulDeviceID; 

    IN ULONG  ulDeviceClassSize; 

    IN ULONG  ulDeviceClassOffset; 

    IN ULONG  ulLibraryNameTotalSize; 

    OUT ULONG ulLibraryNameNeededSize; 

    OUT CHAR  szLibraryName[1]; 

} NDIS_TAPI_CONFIG_DIALOG, *PNDIS_TAPI_CONFIG_DIALOG;

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

ulRequestID
예약됨.

ulDeviceID
구성되어야할 라인 장치를 지정한다. 이것은 앞의 OID_TAPI_PROVIDER_INITIALIZE 요청에서 설정된다.

ulDeviceClassSize
장치-클래스 스트링의 바이트 크기를 지정한다.

ulDeviceClassOffset
구성이 요구되는 장치의 클래스를 지정하는 카운트된 가변-크기인, 0-종료까지 바이트에서 옵셋을 지정한다. 유효한 장치 클래스 스티링은 그것이 "라인" 장치에 적용될 때 OID_TAPI_GET_ID 요청을 위해서 지정된 이러한 것과 똑같다. (ulSelect 는 값 LINECALLSELECT_LINE를 가진다.)

ulLibraryNameTotalSize
szLibraryName 멤버의 바이트 크기를 지정한다.

ulLibraryNameNeededSize
모든 리턴된 정보를 보유하기(hold)위해서 필요한 바이트 크기를 지정하다.

szLibraryName
요청된 장치에 대한 구성 DLL을 이름으로 하는(nameing) 0-종료된 스트링을 위한 공간을 지정한다. Names은 기본 경로와 확장들을 결정하기 위한 Win32 LoadLibrary 에 의해서 사용된 룰에 좌우될(subject) 완성 경로와 확장들을 포함하지 않는다. 만약 미니포트가 이 버퍼가 모든 정보를 보유하는데 너무 작다면, 그것은 ulLibraryNameNeededSize 멤버에 필요한 크기를 지정해야하고, NDIS_STATUS_TAPI_STRUCTURETOOSMALL 에러를 리턴해야한다.

MiniportQueryInformation 함수는 아래중의 하나를 리턴할 수 있다.:
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_STRUCTURETOOSMALL
NDIS_STATUS_TAPI_INVALDEVICECLASS
NDIS_STATUS_TAPI_OPERATIONUNAVAIL
NDIS_STATUS_TAPI_RESOURCEUNAVAIL
NDIS_STATUS_FAILURE

OID_TAPI_DEV_SPECIFIC

이 OID는 다른 OID 요청들을 통해서 접근될 수 없는 형태들에(features) 접근을 제공할 것을 미니포트에게 요청한다. 확장의 의미는 장치-특정이어서, 어플리케이션은 이런 확장들을 이용하기 위해서 그들을 완전히 알아야한다.

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

이 요청은 다른 TAPI OID 요청들에 지정되지 않은 형태들에 대한 접근을 쿼리하고 접근하기 위해서 아래에 정의된 NDIS_TAPI_DEV_SPECIFIC 구조체를 사용한다.: 


typedef struct _NDIS_TAPI_DEV_SPECIFIC { 

    IN ULONG      ulRequestID; 

    IN HDRV_LINE  hdLine; 

    IN ULONG      ulAddressID; 

    IN HDRV_CALL  hdCall; 

    IN OUT ULONG  ulParamsSize; 

    IN OUT UCHAR  Params[1]; 

} NDIS_TAPI_DEV_SPECIFIC, *PNDIS_TAPI_DEV_SPECIFIC;

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

ulRequestID
예약됨.

hdLine
동작되는 라인에 대한 미니포트의 핸들을 지정한다.

ulAddressID
동작되는 지정된 라인상에 있는 주소를 지정한다.

hdCall
동작되는 호출에 대한 미니포트의 핸들을 지정한다. 이 멤버는 NULL 일 수 있다.

ulParamsSize
아래의 파라미터 블럭에 있는 바이트 수를 지정한다. 진입(entry)에서, 이 멤버는 미니포트에 통과된 파라미터 블럭의 바이트 크기를 포함할 것이다.

만약 미니포트가 파라미터 블럭에 정보를 리턴하면, 그것은 입력 ulParamsSize 를 초과할 수 없는 리턴된 정보의 바이트 크기를 이 멤버에 설정해야 한다. 그렇지 않으면, 미니포트는 그것이 어떠한 정보도 리턴하지 않는다는 것을 알리기 위해서 0을 이 멤버를 설정해야한다.

Params
장치-특정 파라미터 블럭을 지정한다.

MiniportQueryInformation 함수는 아래중의 하나를 리턴할 수 있다.:
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_INVALLINEHANDLE
NDIS_STATUS_TAPI_INVALADDRESSID
NDIS_STATUS_TAPI_OPERATIONUNAVAIL
NDIS_STATUS_TAPI_RESOURCEUNAVAIL
NDIS_STATUS_FAILURE

OID_TAPI_GET_EXTENSION_ID

지정된 라인 장치에 대한 확장 ID를 리턴할 것을 미니포트에게 요청한다.

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

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


typedef struct _NDIS_TAPI_GET_EXTENSION_ID { 

    IN ULONG               ulRequestID; 

    IN ULONG               ulDeviceID; 

    OUT LINE_EXTENSION_ID  LineExtensionID; 

} NDIS_TAPI_GET_EXTENSION_ID, *PNDIS_TAPI_GET_EXTENSION_ID;

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

ulRequestID
예약됨.

ulDeviceID
요구되는 링크나 데이터 채널을 지정한다. 이것은 앞의 OID_TAPI_GET_ID 요청에서 설정된다.

LineExtensionID
타입 LINE_EXTENSION_ID 의 구조체를 가리킨다. 세부적인 것은 ndistapi.h 을 봐라.

만약 미니포트가 장치-특정 확장들을 지원한다면, 그것은 이러한 확장들의 확장 ID로 이 구조체를 채운다. 그렇지 않으면, 그것은 이 구조체를 0으로 채운다.

바운드 프로토콜을 위해서, 유효한 확장 ID는 모두 0들로 구성할 수 없다.

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

OID_TAPI_NEGOTIATE_EXT_VERSION

이 OID는 미니포트가 가능한 확장 버전들들의 범위 주어진 이 장치하에서 동작할 미니포트의 최상위 버전 확장 번호를 리턴할 것을 미니포트에게 요청한다.(애매??)

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

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


typedef struct _NDIS_TAPI_NEGOTIATE_EXT_VERSION { 

    IN ULONG   ulRequestID; 

    IN ULONG   ulDeviceID; 

    IN ULONG   ulLowVersion; 

    IN ULONG   ulHighVersion; 

    OUT ULONG  ulExtVersion; 

} NDIS_TAPI_NEGOTIATE_EXT_VERSION, *PNDIS_TAPI_NEGOTIATE_EXT_VERSION;

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

ulRequestID
예약됨.

ulDeviceID
수행되는 확장 버전 협상에 대한 링크와 데이터 채널을 지정한다. 이 INITIALIZE_NEGOTIATION 는 사용될 수 없다. 이것은 앞의 OID_TAPI_GET_ID 에서 설정된다.

ulLowVersion
NDISTAPI 또는 그것의 클라이언트 어플리케이션이 동작할 아래에서 최하위 확장을 지정한다. 최상위 두개의 바이트(most significant two bytes)는 메이저 버전을 지정하고 최하위 두개의 바이트(least significant two bytes)는 마이너 버전을 지정한다. 이 요청이 만들어질 때, 이 멤버의 값은 NDISTAPI에 의해서 입증되지 않는다.

ulHighVersion
NDISTAPI 또는 그것의 클라이언트 어플리케이션이 동작할 아래에서 최상위 확장을 지정한다. 최상위 두개의 바이트(most significant two bytes)는 메이저 버전을 지정하고 최하위 두개의 바이트(least significant two bytes)는 마이너 버전을 지정한다. 이 요청이 만들어질 때, 이 멤버의 값은 NDISTAPI에 의해서 입증되지 않는다.

ulExtVersion
ulLowVersion 와 ulHighVersion에 의해서 지정된 범위내에서 미니포트의 확장 버전을 지정한다. 최상위 두개의 바이트(most significant two bytes)는 메이저 버전을 지정하고 최하위 두개의 바이트(least significant two bytes)는 마이너 버전을 지정한다.

미니포트는 이 요청을 성공적으로 완성하기 위해서 동작할 아래에서, 호출자에 의해서 요청된 범위내에서 최상위 확장 버전 넘버로 이 멤버를 채운다.

만약 ulLowVersion 와 ulHighVersion에 지정된 요청된 범위가 미니포트에 의해서 지원된 범위에 중첩하지 않는다면, 그것은 NDIS_STATUS_TAPI_INCOMPATIBLEEXTVERSION 을 리턴한다.

MiniportQueryInformation 함수는 아래중의 하나를 리턴할 수 있다.:
NDIS_STATUS_SUCCESS
NDIS_STATUS_PENDING
NDIS_STATUS_TAPI_INCOMPATIBLEEXTVERSION
NDIS_STATUS_TAPI_NODRIVER
NDIS_STATUS_TAPI_RESOURCEUNAVAIL
NDIS_STATUS_FAILURE