TSPI_phoneDevSpecific-Funktion (tspi.h)
Die TSPI_phoneDevSpecific-Funktion wird als allgemeiner Erweiterungsmechanismus verwendet, um eine Telefonie-API-Implementierung zu ermöglichen, um Features bereitzustellen, die in den anderen Vorgängen nicht beschrieben sind. Die Bedeutungen dieser Erweiterungen sind gerätespezifisch.
Syntax
LONG TSPIAPI TSPI_phoneDevSpecific(
DRV_REQUESTID dwRequestID,
HDRVPHONE hdPhone,
LPVOID lpParams,
DWORD dwSize
);
Parameter
dwRequestID
Der Bezeichner der asynchronen Anforderung.
hdPhone
Der Griff zum Telefon, auf dem ein gerätespezifischer Vorgang ausgeführt werden soll.
lpParams
Ein Zeiger auf einen Speicherbereich, der zum Speichern eines Parameterblocks verwendet wird. Die Interpretation ist gerätespezifisch. Der lpParams-Parameter sollte keine Zeiger enthalten. Um Informationen von TSPI_phoneDevSpecific an die Anwendung zurückzuholen, sendet der Dienstanbieter eine PHONE_DEVSPECIFIC Nachricht mit den Informationen.
dwSize
Die Größe des Parameterblockbereichs in Bytes.
Rückgabewert
Gibt dwRequestID oder eine Fehlernummer zurück, wenn ein Fehler auftritt. Der tatsächliche lResult-Parameter der entsprechenden ASYNC_COMPLETION ist 0, wenn die Funktion erfolgreich ist, oder es ist eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind wie folgt:
PHONEERR_INVALPHONEHANDLE, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALPOINTER, PHONEERR_NOMEM, PHONEERR_OPERATIONFAILED, PHONEERR_RESOURCEUNAVAIL.
Hinweise
Zusätzliche Rückgabewerte sind gerätespezifisch.
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.
Diese Funktion wird als direkte Antwort auf eine Anwendung aufgerufen, die die TAPI phoneDevSpecific-Funktion aufgerufen hat. TAPI übersetzt den auf TAPI-Ebene verwendeten hPhone-Parameter in den entsprechenden hdPhone-Parameter , der auf DER TSPI-Ebene verwendet wird. Der lpParams-Puffer wird unverändert übergeben.
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.
Anforderungen
| Zielplattform | Windows |
| Kopfzeile | tspi.h |