OID_CO_TAPI_LINE_CAPS

Die OID_CO_TAPI_LINE_CAPS OID fordert einen Anrufmanager oder einen integrierten MCM-Treiber (Miniport Call Manager) an, die Telefoniefunktionen für eine angegebene Leitung zurückzugeben. Dieses OID fordert auch den Anrufmanager oder MCM-Treiber an, anzugeben, ob Adressen in dieser Zeile über unterschiedliche Telefoniefunktionen verfügen.

Diese Anforderung verwendet eine CO_TAPI_LINE_CAPS Struktur, die wie folgt definiert ist, um die Telefoniefunktionen einer angegebenen Zeile abzufragen:

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;

Die Elemente dieser Struktur enthalten die folgenden Informationen:

ulLineID-
Gibt die Zeile an, für die Telefoniefunktionen zurückgegeben werden sollen. ulLineID- ist ein nullbasierter Bezeichner.

ulFlags-
Wenn die Leitung mehrere Adressen unterstützt, die über unterschiedliche Telefoniefunktionen verfügen, legt der Anrufmanager oder MCM-Treiber das CO_TAPI_FLAG_PER_ADDRESS_CAPS Bit in ulFlags fest; andernfalls löscht der Anrufmanager oder MCM-Treiber dieses Bit. Alle nicht definierten Bits sind reserviert und müssen auf 0 festgelegt werden.

LineDevCaps-
Gibt die Telefoniefunktionen einer Linie an, die als LINE_DEV_CAPS Struktur formatiert ist. Weitere Informationen zu dieser Struktur finden Sie im Microsoft Windows SDK und in der Headerdatei "ndistapi.h".

Bemerkungen

Nach der Abfrage der Telefoniefunktionen des Gerätes eines Anrufmanagers oder mcM-Treibers mit OID_CO_TAPI_CM_CAPSfragt ein verbindungsorientierter Client die Telefoniefunktionen der vom Gerät unterstützten Leitungen ab.

• Wenn alle vom Gerät unterstützten Zeilen über die gleichen Zeilenfunktionen verfügen und alle Adressen in diesen Zeilen über die gleichen Adressfunktionen verfügen, OID_CO_TAPI_LINE_CAPS fragt der Client einmal ab, um die Zeilenfunktionen des Geräts abzurufen. In diesem Fall gelten die vom Anrufmanager oder MCM-Treiber zurückgegebenen Leitungsfunktionen für alle vom Gerät unterstützten Leitungen.
• Wenn das Gerät jedoch mehrere Zeilen mit unterschiedlichen Funktionen unterstützt, und/oder wenn Adressen in diesen Zeilen über unterschiedliche Adressfunktionen verfügen, OID_CO_TAPI_LINE_CAPS fragt der Client einmal für jede zeile, die vom Gerät unterstützt wird, um die Funktionen jeder Zeile abzurufen.

Die einstellung ulFlags bestimmt, wie oft der Client anschließend die Funktionen der Adresse(en) in der Zeile abfragt:

• Wenn die Zeile nur eine Adresse unterstützt oder wenn die Zeile mehrere Adressen unterstützt, die über die gleichen Adressfunktionen verfügen, fragt der Client einmal OID_CO_TAPI_ADDRESS_CAPS ab.
• Wenn die Zeile mehrere Adressen unterstützt, die unterschiedliche Funktionen aufweisen, muss der Client nach jeder Adresse in der Zeile einmal abfragen OID_CO_TAPI_ADDRESS_CAPS.

Anforderungen

Version: Windows Vista und höher Header-: Ntddndis.h (enthalten Ndis.h)