TSPI_phoneGetID-Funktion (tspi.h)

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

Syntax

LONG TSPIAPI TSPI_phoneGetID(
  HDRVPHONE   hdPhone,
  LPVARSTRING lpDeviceID,
  LPCWSTR     lpszDeviceClass,
  HANDLE      hTargetProcess
);

Parameter

hdPhone

Der Griff für das abzufragte Telefon.

lpDeviceID

Ein Zeiger auf eine Datenstruktur vom Typ VARSTRING , in der der Gerätebezeichner zurückgegeben wird. 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. Vor dem Aufrufen TSPI_phoneGetID legt die Anwendung den dwTotalSize-Member dieser Struktur fest, um die Menge an Arbeitsspeicher anzugeben, die TAPI für die Rückgabe von Informationen zur Verfügung steht.

lpszDeviceClass

Ein Zeiger auf eine Unicode-Zeichenfolge mit Null-Beendigung, die die Geräteklasse des Geräts angibt, dessen Bezeichner angefordert wird.

hTargetProcess

Das Prozesshandle der Anwendung, für die die TSPI_phoneGetID-Funktion aufgerufen wird. Wenn die in der VARSTRING-Struktur zurückgegebenen Informationen ein Handle zur Verwendung durch die Anwendung enthalten, erstellt oder dupliziert der Dienstanbieter das Handle für den Prozess.

Rückgabewert

Gibt null zurück, wenn die Funktion erfolgreich ist, oder eine Fehlernummer, wenn ein Fehler auftritt. Mögliche Rückgabewerte sind wie folgt:

PHONEERR_INVALPHONEHANDLE, PHONEERR_RESOURCEUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_OPERATIONFAILED, PHONEERR_NOMEM, PHONEERR_OPERATIONUNAVAIL.

Hinweise

Dieser Vorgang kann verwendet werden, um eine Telefongeräte-ID bei einem Telefonhandle abzurufen. Es kann auch verwendet werden, um den Gerätebezeichner des Mediengeräts (für Geräteklassen wie COM, wave, MIDI, phone, line und mciwave) abzurufen, die dem geöffneten Telefongerät zugeordnet sind. Dieser Bezeichner kann dann mit der entsprechenden Medien-API (z. B. mci, midi und wav) verwendet werden, um das entsprechende Gerät auszuwählen. Weitere Informationen zu gängigen Geräteklassennamen finden Sie unter TSPI-Geräteklassen.

Der Dienstanbieter füllt alle Member der VARSTRING-Datenstruktur aus, mit Ausnahme von dwTotalSize, das von TAPI ausgefüllt wird. Der Dienstanbieter darf den dwTotalSize-Member nicht überschreiben.

Der Dienstanbieter muss sich nicht um die Verarbeitung der Geräteklassen tapi/line und tapi/phone kümmern, da TAPI diese für den Dienstanbieter verarbeitet. Daher ist Code für die Verarbeitung dieser Geräteklassen optional.

Anforderungen

Weitere Informationen

VARSTRING