TSPI_lineGetDevCaps-Funktion (tspi.h)
Die TSPI_lineGetDevCaps-Funktion fragt ein angegebenes Leitungsgerät ab, um dessen Telefoniefunktionen zu ermitteln. Die zurückgegebenen Informationen sind für alle Adressen auf dem Leitungsgerät gültig.
Syntax
LONG TSPIAPI TSPI_lineGetDevCaps(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
DWORD dwExtVersion,
LPLINEDEVCAPS lpLineDevCaps
);
Parameter
dwDeviceID
Das abzufragte Zeilengerät.
dwTSPIVersion
Die ausgehandelte TSPI-Versionsnummer. Dieser Wert wurde für dieses Gerät bereits über die TSPI_lineNegotiateTSPIVersion-Funktion ausgehandelt.
dwExtVersion
Die ausgehandelte Erweiterungsversionsnummer. Dieser Wert wurde für dieses Gerät bereits über die TSPI_lineNegotiateExtVersion-Funktion ausgehandelt. Dieser Parameter wird nicht von TAPI überprüft, wenn diese Funktion aufgerufen wird.
lpLineDevCaps
Ein Zeiger auf eine strukturvariable Größe vom Typ LINEDEVCAPS. Nach erfolgreichem Abschluss der Anforderung wird diese Struktur mit Informationen zu Den Funktionen des Zeilengeräts gefüllt.
Rückgabewert
Gibt null zurück, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind wie folgt:
LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONFAILED, LINEERR_NODRIVER, LINEERR_RESOURCEUNAVAIL, LINEERR_NOMEM.
Hinweise
Die Nummerierung des Zeilengerätebezeichners für einen Dienstanbieter ist sequenziell von dem Wert, der durch den dwLineDeviceIDBase-Parameter festgelegt wird, der an die TSPI_providerInit-Funktion übergeben wird.
Der formale Parameter dwExtVersion gibt die Versionsnummer der angeforderten Erweiterungsinformationen an. Wenn es null ist, werden keine Erweiterungsinformationen angefordert. Wenn es nicht zero ist, enthält es einen Wert, der für dieses Gerät mit der TSPI_lineNegotiateExtVersion-Funktion ausgehandelt wurde. Der Dienstanbieter füllt geräte- und herstellerspezifische erweiterte Informationen gemäß der angegebenen Erweiterungsversion aus.
Der Dienstanbieter füllt alle Member der LINEDEVCAPS-Datenstruktur aus, mit Ausnahme von dwTotalSize, das von TAPI ausgefüllt wird. Der Dienstanbieter darf den dwTotalSize-Member nicht überschreiben.
Der Dienstanbieter muss alle Elemente der LINETERMCAPS-Datenstruktur oder -strukturen ausfüllen, die in den unterschiedlichen Teil der LINEDEVCAPS-Datenstruktur eingebettet sind.
Nachdem der Dienstanbieter von der funktion TSPI_lineGetDevCaps zurückgegeben hat, legt TAPI den dwLinesStates-Member der LINEDEVCAPS-Struktur wie folgt fest:
LINEDEVCAPS.dwLineStates |=
LINEDEVSTATE_OPEN |
LINEDEVSTATE_CLOSE |
LINEDEVSTATE_REINIT |
LINEDEVSTATE_TRANSLATECHANGE;
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |