次の方法で共有

OID_CO_TAPI_TRANSLATE_TAPI_CALLPARAMS

  • [アーティクル]

OID_CO_TAPI_TRANSLATE_TAPI_CALLPARAMS OID は、Call Manager または統合 Call Manager ミニポート (MCM) ドライバーに、TAPI 呼び出しパラメーターを NDIS 呼び出しパラメーターに変換するように要求します。 この 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 ビットを設定し、Call Manager または 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 呼び出しパラメーターを指定します。

解説

要求が成功した場合、Call Manager または MCM ドライバーは、NdisCallParams によって参照される CO_CALL_PARAMETERS 構造体に変換された NDIS 呼び出しパラメーターを入力します。 Call Manager または MCM ドライバーは、NdisCallParams によって参照されるフラット メモリ セクション内の CO_CALL_PARAMETERS 構造体を割り当てる必要があります。 クライアントは、CO_CALL_PARAMETERS 構造体の合計の長さを NdisCallParams.Length に書き込みます。

クライアントが ulFlags で CO_TAPI_USE_DEFAULT_CALLPARAMS ビットを設定した場合、クライアントは TAPI 呼び出しパラメーターを指定しません。 この場合、Call Manager または MCM ドライバーは、デバイスの既定の NDIS 呼び出しパラメーターを返す必要があります。 デバイスの既定の NDIS 呼び出しパラメーターがない場合、Call Manager または MCM ドライバーは NDIS_STATUS_FAILURE を返す必要があります。

要件

バージョン: Windows Vista 以降の ヘッダー: Ntddndis.h (Ndis.h を含む)