OID_CO_TAPI_LINE_CAPS

  • [アーティクル]

OID_CO_TAPI_LINE_CAPS OID は、Call Managerまたは統合ミニポートCall Manager (MCM) ドライバーに、指定された行の電話通信機能を返すように要求します。 また、この OID は、Call Manager または MCM ドライバーにこの行のアドレスに異なる電話通信機能があるかどうかを示すように要求します。

この要求では、次のように定義された CO_TAPI_LINE_CAPS 構造体を使用して、指定された行の電話通信機能に対してクエリを実行します。

typedef struct _CO_TAPI_LINE_CAPS {
    IN  ULONG           ulLineID;
    OUT ULONG           ulFlags;
    OUT LINE_DEV_CAPS   LineDevCaps;
} CO_TAPI_LINE_CAPS, *PCO_TAPI_LINE_CAPS;

この構造体のメンバーには、次の情報が含まれています。

ulLineID
電話通信機能を返す必要がある行を指定します。 ulLineID は 0 から始まる識別子です。

ulFlags
回線が異なる電話通信機能を持つ複数のアドレスをサポートしている場合、Call Manager または MCM ドライバーは ulFlags で CO_TAPI_FLAG_PER_ADDRESS_CAPS ビットを設定します。それ以外の場合、Call Manager または MCM ドライバーがこのビットをクリアします。 すべての未定義のビットは予約されており、0 に設定する必要があります。

LineDevCaps
LINE_DEV_CAPS 構造体として書式設定された回線の電話通信機能を指定します。 この構造体の詳細については、Microsoft Windows SDK と ndistapi.h ヘッダー ファイルを参照してください。

解説

OID_CO_TAPI_CM_CAPS を使用して Call Manager または MCM ドライバーのデバイスの電話通信機能を照会した後、接続指向クライアントは、デバイスでサポートされている回線の電話通信機能に対してクエリを実行します。

  • デバイスでサポートされているすべての回線に同じ回線機能があり、これらの行のすべてのアドレスが同じアドレス機能を持つ場合、クライアントはデバイスの回線機能を取得するために 1 回 OID_CO_TAPI_LINE_CAPS クエリを実行します。 この場合、Call Manager または MCM ドライバーによって返される回線機能は、デバイスでサポートされているすべての回線に適用されます。
  • ただし、デバイスが異なる機能を持つ複数の回線をサポートしている場合や、これらの回線のアドレスに異なるアドレス機能がある場合、クライアントはデバイスでサポートされている各回線に対して 1 回 OID_CO_TAPI_LINE_CAPS クエリを実行して、各回線の機能を取得します。

ulFlags 設定は、クライアントが後で回線のアドレスの機能を照会する回数を決定します。

  • 回線でサポートされているアドレスが 1 つだけの場合、または同じアドレス機能を持つ複数のアドレスが回線でサポートされている場合、クライアントは 1 回 OID_CO_TAPI_ADDRESS_CAPS クエリを実行します。
  • 回線が異なる機能を持つ複数のアドレスをサポートしている場合、クライアントは回線のアドレスごとに 1 回 OID_CO_TAPI_ADDRESS_CAPS クエリを実行する必要があります。

要件

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