TSPI_lineDevSpecific-Funktion (tspi.h)
Die TSPI_lineDevSpecific-Funktion wird als allgemeiner Erweiterungsmechanismus verwendet, um Dienstanbietern den Zugriff auf Features zu ermöglichen, die in anderen Vorgängen nicht beschrieben sind. Die Bedeutungen der Erweiterungen sind gerätespezifisch, und um diese Erweiterungen zu nutzen, muss die Anwendung sie vollständig kennen.
Syntax
LONG TSPIAPI TSPI_lineDevSpecific(
DRV_REQUESTID dwRequestID,
HDRVLINE hdLine,
DWORD dwAddressID,
HDRVCALL hdCall,
LPVOID lpParams,
DWORD dwSize
);
Parameter
dwRequestID
Der Bezeichner der asynchronen Anforderung.
hdLine
Der Handgriff des Dienstanbieters an die zu betreibende Leitung.
dwAddressID
Die Adresse auf der angegebenen Leitung, die betrieben werden soll. Ein Adressbezeichner ist einer Adresse dauerhaft zugeordnet. Der Bezeichner bleibt über Betriebssystemupgrades hinweg konstant.
hdCall
Der Handle des Dienstanbieters für den zu betreibenden Anruf. Dieses Feld kann den Wert NULL aufweisen. Der Anrufstatus von hdCall ist gerätespezifisch.
lpParams
Ein Zeiger auf einen Speicherbereich, der zum Speichern eines Parameterblocks verwendet wird. Das Format dieses Parameterblocks ist gerätespezifisch.
dwSize
Die Größe des Parameterblockbereichs in Bytes. Wenn der lpParams-Parameter ein Zeiger auf eine Zeichenfolge ist, muss die Größe den NULL-Abschlussator enthalten.
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 eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind wie folgt:
LINEERR_INVALLINEHANDLE, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_NOMEM, LINEERR_RESOURCEUNAVAIL.
Hinweise
Zusätzliche Rückgabewerte sind gerätespezifisch.
Dieser Vorgang stellt ein generisches Parameterprofil bereit. Die Interpretation der Parameterstruktur ist gerätespezifisch. TAPI gibt immer den hdLine-Parameter an. Ob dwAddressID und/oder hdCall als gültig gelten, ist gerätespezifisch. Falls angegeben, müssen sie zu hdLine gehören. Gerätespezifische Hinweise und Antworten, die an die Anwendung zurückgesendet werden, verwenden die LINE_DEVSPECIFIC-Nachricht .
Diese Funktion wird als direkte Antwort auf eine Anwendung aufgerufen, die die TAPI-Funktion lineDevSpecific aufruft. TAPI übersetzt die auf TAPI-Ebene verwendeten hLine - und hdCall-Parameter in die entsprechenden hdLine - und hdCall-Parameter , die auf DER TSPI-Ebene verwendet werden. Der lpParams-Puffer wird unverändert übergeben.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |