phoneGetDevCapsA-Funktion (tapi.h)

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

Syntax

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

Parameter

hPhoneApp

Behandeln Sie die Registrierung der Anwendung mit TAPI.

dwDeviceID

Der Bezeichner des telefonbasierten Geräts, das abgefragt werden soll.

dwAPIVersion

Versionsnummer der zu verwendenden Telefonie-API. Das Hochreihenfolgenwort enthält die Hauptversionsnummer; Das Wort mit niedriger Reihenfolge enthält die Nebenversionsnummer. Diese Nummer wird mit der Funktion phoneNegotiateAPIVersionabgerufen.

dwExtVersion

Versionsnummer der zu verwendenden Dienstanbietererweiterungen. Diese Nummer wird mit der Funktion phoneNegotiateExtVersionabgerufen. Es kann null bleiben, wenn keine gerätespezifischen Erweiterungen verwendet werden sollen. Andernfalls enthält das Wort "Hochreihenfolge" die Hauptversionsnummer; Das Wort mit niedriger Reihenfolge enthält die Nebenversionsnummer.

lpPhoneCaps

Zeiger auf eine variabel angepasste Struktur des Typs PHONECAPS. Nach erfolgreichem Abschluss der Anforderung wird diese Struktur mit Informationen zur Telefongerätefunktionen gefüllt.

Rückgabewert

Gibt Null zurück, wenn die Anforderung erfolgreich ist oder eine negative Fehlernummer auftritt, 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.

Bemerkungen

Bevor sie phoneGetDevCapsverwenden, muss die Anwendung die zu verwendende TAPI-Versionsnummer aushandeln (siehe phoneNegotiateAPIVersion) und optional die zu verwendende Erweiterungsversion (siehe phoneNegotiateExtVersion).

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

Anmerkung

Der header tapi.h definiert phoneGetDevCaps als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	tapi.h
Library	Tapi32.lib
DLL-	Tapi32.dll

Siehe auch

PHONECAPS-

ergänzende Telefondienstfunktionen

TAPI 2.2 Referenzübersicht

phoneNegotiateAPIVersion

phoneNegotiateExtVersion