Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die phoneGetID--Funktion gibt einen Gerätebezeichner für die angegebene Geräteklasse zurück, die dem angegebenen Telefongerät zugeordnet ist.
Syntax
LONG phoneGetIDW(
HPHONE hPhone,
LPVARSTRING lpDeviceID,
LPCWSTR lpszDeviceClass
);
Parameter
hPhone
Behandeln eines geöffneten Telefongeräts.
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 der Geräte-ID 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
Zeigen Sie auf eine mit 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 auftritt, 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.
Bemerkungen
Die phoneGetID--Funktion kann verwendet werden, um einen Telefongerätebezeichner anhand eines Telefonhandle abzurufen. Sie kann auch verwendet werden, um den Gerätebezeichner des Mediengeräts (für Geräteklassen wie COM, Wave, MIDI, Phone, Line 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 zum Verwalten von Geräten des Medientyps definieren. Um Konflikte mit Geräteklassennamen zu vermeiden, die unabhängig von verschiedenen Anbietern zugewiesen werden, sollte ein Anbieter einen Namen auswählen, der sowohl den Anbieter als auch den Medientyp eindeutig identifiziert. Beispiel: "intel/video".
Anmerkung
Der Tapi.h-Header definiert phoneGetID 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 |