TSPI_lineSetDefaultMediaDetection-Funktion (tspi.h)

Artikel
03/09/2024

Die TSPI_lineSetDefaultMediaDetection-Prozedur teilt dem Dienstanbieter mit, dass der neue Satz von Medientypen für die angegebene Zeile erkannt werden soll (wobei ein vorheriger Satz ersetzt wird). Außerdem wird der anfängliche Satz von Medientypen festgelegt, die bei nachfolgenden Aufrufen (ein- oder ausgehend) in dieser Zeile überwacht werden sollen.

Syntax

LONG TSPIAPI TSPI_lineSetDefaultMediaDetection(
  HDRVLINE hdLine,
  DWORD    dwMediaModes
);

Parameter

hdLine

Das Handle für die Zeile, um die Medienüberwachung festzulegen.

dwMediaModes

Die Medientypen, die für TAPI von Interesse sind. Dieser Parameter verwendet eine der LINEMEDIAMODE_ Konstanten:

Rückgabewert

Gibt null zurück, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALMEDIAMODE, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM, LINEERR_NODRIVER, LINEERR_OPERATIONUNAVAIL.

Hinweise

TAPI ruft diese Funktion in der Regel auf, um den Satz der erkannten Medientypen für die Zeile in die Vereinigung aller Modi zu aktualisieren, die von allen ausstehenden Zeilen ausgewählt wurdenÖffnent, wenn eine Zeile auf TAPI-Ebene geöffnet oder geschlossen ist. Ein LineOpen-Aufrufversuch wird abgelehnt, wenn die Medienerkennung abgelehnt wird. Ein einzelner Aufruf dieser Prozedur ist in der Regel das Ergebnis eines lineOpen-Aufrufs , der den Gerätebezeichner LINEMAPPER nicht angibt. Der Gerätebezeichner LINEMAPPER wird nie auf TSPI-Ebene verwendet.

TAPI muss die Von allen Clients gewünschte Vereinigung der Medientypen berechnen und das Ergebnis an diese Funktion übergeben. Der Dienstanbieter verwendet den Satz, der von TAPI an diese Funktion übergeben wird. TAPI stellt sicher, dass für den dwMediaModes-Parameter mindestens ein Bit festgelegt ist und keine reservierten Bits festgelegt sind. Der Dienstanbieter muss weitere Gültigkeitsprüfungen für die Medientypen durchführen, z. B. überprüfen, ob Medientypen tatsächlich vom Dienstanbieter unterstützt werden. Die Union aller Medientypen kann den Wert 0 aufweisen, wenn die Anwendungen, für die die Zeile geöffnet ist, entweder Monitore sind oder nicht an der Verarbeitung eingehender Anrufe interessiert sind.

Es gibt keine direkt entsprechende Funktion auf TAPI-Ebene. Diese Prozedur entspricht den "Anforderungsmedientypen", die für die spezifische Zeile der lineOpen-Prozedur impliziert werden, wenn sie mit dem spezifischen Gerätebezeichner (außer LINEMAPPER) aufgerufen wird.