TSPI_phoneGetDevCaps-Funktion (tspi.h)
Die TSPI_phoneGetDevCaps-Funktion fragt ein angegebenes Telefongerät ab, um dessen Telefoniefunktionen zu bestimmen.
Syntax
LONG TSPIAPI TSPI_phoneGetDevCaps(
DWORD dwDeviceID,
DWORD dwTSPIVersion,
DWORD dwExtVersion,
LPPHONECAPS lpPhoneCaps
);
Parameter
dwDeviceID
Das abzufragte Telefongerät.
dwTSPIVersion
Die ausgehandelte TSPI-Versionsnummer. Dieser Wert wird für dieses Gerät über die funktion TSPI_phoneNegotiateTSPIVersion ausgehandelt.
dwExtVersion
Die ausgehandelte Versionsnummer der Erweiterung. Dieser Wert wird für dieses Gerät über die funktion TSPI_phoneNegotiateExtVersion ausgehandelt.
lpPhoneCaps
Ein Zeiger auf den Speicher, in den der Dienstanbieter eine strukturvariable Größe vom Typ PHONECAPS schreibt. Nach erfolgreichem Abschluss der Anforderung wird diese Struktur mit Informationen zur Telefongerätefunktion gefüllt. Vor dem Aufruf TSPI_phoneGetDevCaps legt die Anwendung den dwTotalSize-Member dieser Struktur fest, um anzugeben, wie viel Arbeitsspeicher TAPI für die Rückgabe von Informationen zur Verfügung steht.
Rückgabewert
Gibt null zurück, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:
PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_OPERATIONFAILED, PHONEERR_NODRIVER, PHONEERR_OPERATIONUNAVAIL, PHONEERR_NOMEM.
Hinweise
Der Dienstanbieter füllt alle Member der PHONEBUTTONINFO-Datenstruktur aus, mit Ausnahme von dwTotalSize, das von TAPI ausgefüllt wird. Der Dienstanbieter darf den dwTotalSize-Member nicht überschreiben.
Wenn dwExtVersion null ist, werden keine Erweiterungsinformationen angefordert. Wenn es ungleich null ist, enthält es einen Wert, der für dieses Gerät bereits mit der funktion TSPI_phoneNegotiateExtVersion ausgehandelt wurde. Der Dienstanbieter füllt geräte- und herstellerspezifische erweiterte Informationen gemäß der angegebenen Erweiterungsversion aus.
Nachdem der Dienstanbieter die funktion TSPI_phoneGetDevCaps zurückgegeben hat, legt TAPI den dwPhoneStates-Member der PHONECAPS-Struktur wie folgt fest:
PHONECAPS.dwPhoneStates |=
PHONESTATE_OWNER |
PHONESTATE_MONITORS |
PHONESTATE_REINIT;
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |