phoneGetID-Funktion (tapi.h)

Die phoneGetID-Funktion gibt einen Gerätebezeichner für die angegebene Geräteklasse zurück, die dem angegebenen Telefongerät zugeordnet ist.

Syntax

LONG phoneGetID(
  HPHONE      hPhone,
  LPVARSTRING lpDeviceID,
  LPCSTR      lpszDeviceClass
);

Parameter

hPhone

Handle mit einem geöffneten Telefongerät.

lpDeviceID

Zeiger auf eine Datenstruktur vom Typ VARSTRING , in der der Gerätebezeichner zurückgegeben wird. Nach erfolgreichem Abschluss der Anforderung wird dieser Speicherort mit dem Gerätebezeichner gefüllt. Das Format der zurückgegebenen Informationen hängt von der Methode ab, die von der Geräteklasse (API) zum Benennen von Geräten verwendet wird.

lpszDeviceClass

Zeiger auf eine NULL-beendete Zeichenfolge, die die Geräteklasse des Geräts angibt, dessen Bezeichner angefordert wird. Gültige Geräteklassenzeichenfolgen werden im Abschnitt System.ini verwendet, um Geräteklassen zu identifizieren.

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_INVALPHONEHANDLE, PHONEERR_NOMEM, PHONEERR_INVALPOINTER, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_UNINITIALIZED, PHONEERR_OPERATIONFAILED, PHONEERR_STRUCTURETOOSMALL, PHONEERR_OPERATIONUNAVAIL.

Hinweise

Die phoneGetID-Funktion kann verwendet werden, um einen Telefongerätebezeichner mit einem Telefonhandle abzurufen. Es kann auch verwendet werden, um den Gerätebezeichner des Mediengeräts (für Geräteklassen wie COM, Wave, MIDI, Telefon, Leitung oder NDIS) abzurufen, die dem geöffneten Telefongerät zugeordnet sind. Bei den Namen dieser Geräteklasse wird die Groß-/Kleinschreibung nicht beachtet. Dieser Bezeichner kann dann mit der entsprechenden Medien-API verwendet werden, um das entsprechende Gerät auszuwählen.

Informationen zu Geräteklassennamen finden Sie unter TAPI-Geräteklassen .

Ein Anbieter, der einen gerätespezifischen Medientyp definiert, muss auch die entsprechende gerätespezifische (proprietäre) API definieren, um Geräte des Medientyps zu verwalten. Um Kollisionen bei Geräteklassennamen zu vermeiden, die von verschiedenen Anbietern unabhängig zugewiesen werden, sollte ein Anbieter einen Namen auswählen, der sowohl den Anbieter als auch den Medientyp eindeutig identifiziert. Beispiel: "intel/video".

Anforderungen

Weitere Informationen

Zusätzliche Telefondienstfunktionen

ÜBERSICHT ÜBER TAPI 2.2-Referenz

VARSTRING