lineDevSpecific-Funktion (tapi.h)

Artikel
08/26/2023

Die lineDevSpecific-Funktion ermöglicht Dienstanbietern den Zugriff auf Features, die von anderen TAPI-Funktionen nicht angeboten werden. Die Bedeutung der Erweiterungen ist gerätespezifisch, und die Nutzung dieser Erweiterungen erfordert, dass die Anwendung sie vollständig kennt.

Syntax

LONG lineDevSpecific(
  HLINE  hLine,
  DWORD  dwAddressID,
  HCALL  hCall,
  LPVOID lpParams,
  DWORD  dwSize
);

Parameter

hLine

Handle an ein Leitungsgerät. Dieser Parameter ist erforderlich.

dwAddressID

Adressbezeichner auf dem angegebenen Leitungsgerät. Ein Adressbezeichner ist einer Adresse dauerhaft zugeordnet; Der Bezeichner bleibt über Betriebssystemupgrades hinweg konstant.

hCall

Handle für einen Anruf. Dieser Parameter ist optional, aber wenn er angegeben ist, muss der von diesem dargestellte Aufruf zum hLine-Leitungsgerät gehören. Der Anrufstatus von hCall ist gerätespezifisch.

lpParams

Zeiger auf einen Speicherbereich, der zum Speichern eines Parameterblocks verwendet wird. Das Format dieses Parameterblocks ist gerätespezifisch, und sein Inhalt wird von TAPI an oder vom Dienstanbieter übergeben.

dwSize

Größe des Parameterblockbereichs in Bytes.

Rückgabewert

Gibt einen positiven Anforderungsbezeichner zurück, wenn die Funktion asynchron abgeschlossen wird, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Der dwParam2-Parameter der entsprechenden LINE_REPLY Meldung ist null, wenn die Funktion erfolgreich ist, oder es ist eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

LINEERR_INVALADDRESSID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALLINEHANDLE, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_UNINITIALIZED, LINEERR_NOMEM.

Zusätzliche Rückgabewerte sind gerätespezifisch.

Hinweise

Dieser Vorgang ist Teil der erweiterten Telefoniedienste. Sie bietet Zugriff auf ein gerätespezifisches Feature, ohne dessen Bedeutung zu definieren. Dieser Vorgang ist nur verfügbar, wenn die Anwendung erfolgreich eine gerätespezifische Erweiterungsversion ausgehandelt hat.

Diese Funktion stellt ein generisches Parameterprofil bereit. Die Interpretation der Parameterstruktur ist gerätespezifisch. Ob dwAddressID und/oder hCall voraussichtlich gültig sind, ist gerätespezifisch. Wenn angegeben, müssen sie zu hLine gehören. Hinweise und Antworten, die von der Anwendung zurückgesendet werden, die gerätespezifisch sind, sollten die LINE_DEVSPECIFIC Nachricht verwenden.

Ein Dienstanbieter kann den Zugriff auf gerätespezifische Funktionen ermöglichen, indem parameter für die Verwendung mit dieser Funktion definiert werden. Anwendungen, die diese gerätespezifischen Erweiterungen verwenden möchten, sollten die gerätespezifische (in diesem Fall herstellerspezifische) Dokumentation lesen, in der beschrieben wird, welche Erweiterungen definiert sind. In der Regel kann eine Anwendung, die auf diesen gerätespezifischen Erweiterungen basiert, nicht mit anderen Dienstanbieterumgebungen arbeiten.

Vorsicht TAPI schreibt die zurückgegebenen Daten in den Puffer, auf den lParam verweist, wenn die LINE_REPLY Nachricht zurückgegeben wird. Dies bedeutet, dass der Puffer gültig bleiben muss, bis die LINE_REPLY Nachricht zurückgegeben wird. Andernfalls können Datenbeschädigungen und Ausnahmen auftreten.