phoneDevSpecific-Funktion (tapi.h)

Artikel
08/26/2023

Die phoneDevSpecific-Funktion wird als allgemeiner Erweiterungsmechanismus verwendet, um eine Telefonie-API-Implementierung zu ermöglichen, um Features bereitzustellen, die in den anderen TAPI-Funktionen nicht beschrieben sind. Die Bedeutungen dieser Erweiterungen sind gerätespezifisch.

Syntax

LONG phoneDevSpecific(
  HPHONE hPhone,
  LPVOID lpParams,
  DWORD  dwSize
);

Parameter

hPhone

Handle mit einem Telefongerät.

lpParams

Zeiger auf einen Speicherbereich, der zum Speichern eines Parameterblocks verwendet wird. Die Interpretation ist gerätespezifisch. Der Inhalt des Parameterblocks wird von TAPI unverändert 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 PHONE_REPLY Meldung ist 0, wenn die Funktion erfolgreich ist, oder es ist eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

PHONEERR_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_OPERATIONUNAVAIL, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONFAILED.

Zusätzliche Rückgabewerte sind gerätespezifisch.

Hinweise

Dieser Vorgang stellt ein generisches Parameterprofil bereit. Die Interpretation des Parameterblocks ist gerätespezifisch. Gerätespezifische Hinweise und Antworten sollten die PHONE_DEVSPECIFIC Nachricht verwenden.

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