lineDevSpecific-Funktion (tapi.h)
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.
Anforderungen
Zielplattform | Windows |
Kopfzeile | tapi.h |
Bibliothek | Tapi32.lib |
DLL | Tapi32.dll |