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
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi.h |
| Bibliothek | Tapi32.lib |
| DLL | Tapi32.dll |
Weitere Informationen
Zusätzliche Telefondienstfunktionen