lineGetID-Funktion (tapi.h)

Artikel
08/26/2023

Die lineGetID-Funktion gibt einen Gerätebezeichner für die angegebene Geräteklasse zurück, die der ausgewählten Zeile, Adresse oder dem ausgewählten Aufruf zugeordnet ist.

Syntax

LONG lineGetID(
  HLINE       hLine,
  DWORD       dwAddressID,
  HCALL       hCall,
  DWORD       dwSelect,
  LPVARSTRING lpDeviceID,
  LPCSTR      lpszDeviceClass
);

Parameter

hLine

Handle an einem Offenzeilengerät.

dwAddressID

Adresse auf dem angegebenen Open Line-Gerät. Ein Adressbezeichner ist einer Adresse dauerhaft zugeordnet; Der Bezeichner bleibt über Betriebssystemupgrades hinweg konstant.

hCall

Handle für einen Anruf.

dwSelect

Gibt an, ob der angeforderte Gerätebezeichner der Zeile, adresse oder einem einzelnen Anruf zugeordnet ist. Dieser Parameter verwendet nur eine der LINECALLSELECT_ Konstanten.

lpDeviceID

Zeiger auf einen Speicherort vom Typ VARSTRING, an dem 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äteklassen-API zum Benennen von Geräten verwendet wird. Vor dem Aufruf von lineGetID muss die Anwendung den dwTotalSize-Member dieser Struktur festlegen, um anzugeben, wie viel Arbeitsspeicher TAPI zum Zurückgeben von Informationen zur Verfügung steht.

Hinweis Wenn die Größenparameter in der Struktur nicht korrekt sind, besteht die Möglichkeit, dass Daten überschrieben werden. Weitere Informationen zum Festlegen von Strukturgrößen finden Sie im Thema speicherbelegung .

lpszDeviceClass

Zeiger auf eine NULL-endende Zeichenfolge, die die Geräteklasse des Geräts angibt, dessen Bezeichner angefordert wird. Gültige Geräteklassenzeichenfolgen sind diejenigen, die im Abschnitt SYSTEM.INI verwendet werden, 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:

LINEERR_INVALLINEHANDLE, LINEERR_NOMEM, LINEERR_INVALADDRESSID, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALCALLHANDLE, LINEERR_OPERATIONFAILED, LINEERR_INVALCALLSELECT, LINEERR_INVALDEVICECLASS, LINEERR_RESOURCEUNAVAIL, LINEERR_INVALPOINTER, LINEERR_STRUCTURETOOSMALL, LINEERR_NODEVICE, LINEERR_UNINITIALIZED.

Hinweise

Die lineGetID-Funktion kann verwendet werden, um einen Zeilengerätebezeichner abzurufen, wenn ein Zeilenhandle angegeben wird. Dies ist nützlich, nachdem lineOpen mit LINEMAPPER als Gerätebezeichner geöffnet wurde, um den tatsächlichen Line-Device-Bezeichner der geöffneten Zeile zu ermitteln. Diese Funktion kann auch verwendet werden, um die Geräte-ID eines Telefongeräts oder Mediengeräts (für Geräteklassen wie COM, Wave, MIDI, Telefon, Leitung oder NDIS) abzurufen, die einem Anruf, einer Adresse oder einer Leitung zugeordnet sind. Dieser Bezeichner kann dann mit der entsprechenden API (z. B. Telefon, MIDI, Wave) verwendet werden, um das entsprechende Mediengerät auszuwählen, das dem angegebenen Anruf zugeordnet ist.

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

Ein Anbieter, der einen gerätespezifischen Medienmodus definiert, muss auch die entsprechende gerätespezifische (proprietäre) API definieren, um Geräte im Medienmodus zu verwalten. Um Konflikte bei 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".