OID_CO_TAPI_TRANSLATE_TAPI_CALLPARAMS
OID_CO_TAPI_TRANSLATE_TAPI_CALLPARAMS OID는 TAPI 호출 매개 변수를 NDIS 호출 매개 변수로 변환하기 위해 호출 관리자 또는 MCM(통합 통화 관리자 미니포트) 드라이버를 요청합니다. 이 OID를 쿼리하는 클라이언트는 반환된 NDIS 호출 매개 변수를 NdisClMakeCall에 대한 입력(CO_CALL_PARAMETERS 구조 형식)으로 사용하며, 이 매개 변수는 클라이언트가 발신 호출을 수행합니다.
이 OID는 다음과 같이 정의된 CO_TAPI_TRANSLATE_TAPI_CALLPARAMS 구조를 사용합니다.
typedef struct _CO_TAPI_TRANSLATE_TAPI_CALLPARAMS {
IN ULONG ulLineID;
IN ULONG ulAddressID;
IN ULONG ulFlags;
IN NDIS_VAR_DATA_DESC DestAddress;
IN NDIS_VAR_DATA_DESC LineCallParams;
OUT NDIS_VAR_DATA_DESC NdisCallParams;
} CO_TAPI_TRANSLATE_TAPI_CALLPARAMS, *PCO_TAPI_TRANSLATE_TAPI_CALLPARAMS;
이 구조체의 멤버는 다음 정보를 포함합니다.
ulLineID
나가는 호출이 전달될 0부터 시작하는 줄 식별자를 지정합니다.
ulAddressID
발신 호출이 전달될 0부터 시작하는 주소 식별자( ulLineID로 지정된 줄에 있음)를 지정합니다.
ulFlags
클라이언트는 ulFlags에서 CO_TAPI_FLAG_OUTGOING_CALL 비트를 설정해야 합니다. 클라이언트는 필요에 따라 ulFlags 에서 CO_TAPI_USE_DEFAULT_CALLPARAMS 비트를 설정하여 호출 관리자 또는 MCM 드라이버가 LineCallParams 를 무시하고 디바이스에 대한 기본 NDIS 호출 매개 변수를 반환하도록 요구할 수 있습니다.
DestAddress
NDIS_VAR_DATA_DESC 구조체의 시작부터 문자 배열로 서식이 지정된 대상 주소까지 오프셋을 포함하는 NDIS_VAR_DATA_DESC 구조체를 지정합니다. NDIS_VAR_DATA_DESC 구조체에는 대상 주소의 길이도 포함됩니다. 대상 주소는 발신 호출이 전달될 주소입니다.
LineCallParams
NDIS_VAR_DATA_DESC 구조체의 시작부터 LINE_CALL_PARAMS 구조체까지의 오프셋을 포함하는 NDIS_VAR_DATA_DESC 구조체를 지정합니다. NDIS_VAR_DATA_DESC 구조체에는 LINE_CALL_PARAMS 구조체의 길이도 포함됩니다. LINE_CALL_PARAMS 구조는 NDIS 호출 매개 변수로 변환할 TAPI 호출 매개 변수를 지정합니다. LINE_CALL_PARAMS 구조에 대한 자세한 내용은 Microsoft Windows SDK 및 ndistapi.h 헤더 파일을 참조하세요.
NdisCallParams
NDIS_VAR_DATA_DESC 구조체의 시작부터 CO_CALL_PARAMETERS 구조체까지의 오프셋을 포함하는 NDIS_VAR_DATA_DESC 구조체를 지정합니다. NDIS_VAR_DATA_DESC 구조체에는 CO_CALL_PARAMETERS 구조체의 길이도 포함됩니다. CO_CALL_PARAMETERS 구조는 지정된 TAPI 호출 매개 변수가 변환된 NDIS 호출 매개 변수를 지정합니다.
설명
요청이 성공하면 호출 관리자 또는 MCM 드라이버는 NdisCallParams 에서 참조하는 CO_CALL_PARAMETERS 구조를 번역된 NDIS 호출 매개 변수로 채웁니다. 호출 관리자 또는 MCM 드라이버는 NdisCallParams에서 참조하는 플랫 메모리 섹션 내에서 CO_CALL_PARAMETERS 구조를 할당해야 합니다. 클라이언트는 CO_CALL_PARAMETERS 구조체의 총 길이를 NdisCallParams.Length에 씁니다.
클라이언트가 ulFlags에서 CO_TAPI_USE_DEFAULT_CALLPARAMS 비트를 설정하는 경우 클라이언트는 TAPI 호출 매개 변수를 지정하지 않습니다. 이 경우 호출 관리자 또는 MCM 드라이버는 디바이스에 대한 기본 NDIS 호출 매개 변수를 반환해야 합니다. 디바이스에 대한 기본 NDIS 호출 매개 변수가 없는 경우 호출 관리자 또는 MCM 드라이버는 NDIS_STATUS_FAILURE 반환해야 합니다.
요구 사항
버전: Windows Vista 이상 헤더: Ntddndis.h(Ndis.h 포함)