phoneGetDevCaps-Funktion (tapi.h)

Artikel
08/26/2023

Die phoneGetDevCaps-Funktion fragt ein angegebenes Telefongerät ab, um dessen Telefoniefunktionen zu bestimmen.

Syntax

LONG phoneGetDevCaps(
  HPHONEAPP   hPhoneApp,
  DWORD       dwDeviceID,
  DWORD       dwAPIVersion,
  DWORD       dwExtVersion,
  LPPHONECAPS lpPhoneCaps
);

Parameter

hPhoneApp

Verarbeiten sie die Registrierung der Anwendung bei TAPI.

dwDeviceID

Bezeichner des abzufragten Telefongeräts.

dwAPIVersion

Versionsnummer der zu verwendenden Telefonie-API. Das Wort mit hoher Ordnung enthält die Hauptversionsnummer; das Wort mit niedriger Reihenfolge enthält die Nebenversionsnummer. Diese Nummer wird mit der Funktion phoneNegotiateAPIVersion abgerufen.

dwExtVersion

Versionsnummer der zu verwendenden Dienstanbieter-spezifischen Erweiterungen. Diese Nummer wird mit der Funktion phoneNegotiateExtVersion abgerufen. Es kann null gelassen werden, wenn keine gerätespezifischen Erweiterungen verwendet werden sollen. Andernfalls enthält das Wort mit hoher Ordnung die Hauptversionsnummer. das Wort mit niedriger Reihenfolge enthält die Nebenversionsnummer.

lpPhoneCaps

Zeiger auf eine strukturvariable Größe vom Typ PHONECAPS. Nach erfolgreichem Abschluss der Anforderung wird diese Struktur mit Informationen zu Den Funktionen des Telefongeräts gefüllt.

Rückgabewert

Gibt null zurück, wenn die Anforderung erfolgreich ist, oder eine negative Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind:

PHONEERR_INVALAPPHANDLE, PHONEERR_INVALPOINTER, PHONEERR_BADDEVICEID, PHONEERR_OPERATIONFAILED, PHONEERR_INCOMPATIBLEAPIVERSION, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INCOMPATIBLEEXTVERSION, PHONEERR_NOMEM, PHONEERR_STRUCTURETOOSMALL, PHONEERR_RESOURCEUNAVAIL, PHONEERR_NODRIVER, PHONEERR_UNINITIALIZED, PHONEERR_NODEVICE.

Hinweise

Vor der Verwendung von phoneGetDevCaps muss die Anwendung die zu verwendende TAPI-Versionsnummer (siehe phoneNegotiateAPIVersion) und optional die zu verwendende Erweiterungsversion aushandeln (siehe phoneNegotiateExtVersion).

TAPI- und Erweiterungsversionsnummern sind diejenigen, unter denen TAPI, Telefonie-DLL und Dienstanbieter betrieben werden müssen. Wenn sich die Versionsbereiche nicht überschneiden, sind die Anwendungs- und API- oder Dienstanbieterversionen inkompatibel, und es wird ein Fehler zurückgegeben.