OID_CO_TAPI_LINE_CAPS

Die OID_CO_TAPI_LINE_CAPS OID fordert einen Anruf-Manager oder einen integrierten MCM-Treiber (Miniport Call Manager) an, um die Telefoniefunktionen für eine angegebene Leitung zurückzugeben. Diese OID fordert auch den Anruf-Manager oder den MCM-Treiber an, um anzugeben, ob Adressen in dieser Leitung ungleiche Telefoniefunktionen aufweisen.

Diese Anforderung verwendet eine wie folgt definierte CO_TAPI_LINE_CAPS-Struktur, um die Telefoniefunktionen einer angegebenen Leitung 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 Member 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 mit unterschiedlichen Telefoniefunktionen unterstützt, legt der Anruf-Manager oder MCM-Treiber das CO_TAPI_FLAG_PER_ADDRESS_CAPS Bit in ulFlags fest. Andernfalls löscht der Anruf-Manager 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 in der Headerdatei Microsoft Windows SDK und ndistapi.h.

Bemerkungen

Nach dem Abfragen der Telefoniefunktionen des Geräts eines Anruf-Managers oder MCM-Treibers mit OID_CO_TAPI_CM_CAPS fragt ein verbindungsorientierter Client die Telefoniefunktionen der vom Gerät unterstützten Leitungen ab.

• Wenn alle vom Gerät unterstützten Zeilen dieselben Zeilenfunktionen aufweisen und alle Adressen in diesen Zeilen dieselben Adressfunktionen aufweisen, fragt der Client OID_CO_TAPI_LINE_CAPS einmal ab, um die Zeilenfunktionen des Geräts abzurufen. In diesem Fall gelten die vom Anruf-Manager oder MCM-Treiber zurückgegebenen Zeilenfunktionen 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 ungleiche Adressfunktionen aufweisen, fragt der Client einmal für jede vom Gerät unterstützte Zeile OID_CO_TAPI_LINE_CAPS ab, um die Funktionen der einzelnen Zeilen abzurufen.

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

• Wenn die Zeile nur eine Adresse unterstützt oder wenn die Zeile mehrere Adressen mit den gleichen Adressfunktionen unterstützt, fragt der Client einmal OID_CO_TAPI_ADDRESS_CAPS ab.
• Wenn die Zeile mehrere Adressen mit unterschiedlichen Funktionen unterstützt, muss der Client OID_CO_TAPI_ADDRESS_CAPS einmal für jede Adresse in der Zeile abfragen.

Anforderungen

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