TUISPI_phoneConfigDialog-Funktion (tspi.h)

Die funktion TUISPI_phoneConfigDialog bewirkt, dass der Anbieter des angegebenen Telefongeräts ein modales Dialogfeld als untergeordnetes Fenster von hwndOwner anzeigt, damit der Benutzer Parameter im Zusammenhang mit dem Telefongerät konfigurieren kann. Diese Funktion macht die funktion TSPI_phoneConfigDialog in Version 2.0 und höher veraltet (unterstützt in Version 1.4 und früher).

Die Implementierung ist optional.

Syntax

LONG TSPIAPI TUISPI_phoneConfigDialog(
  TUISPIDLLCALLBACK lpfnUIDLLCallback,
  DWORD             dwDeviceID,
  HWND              hwndOwner,
  LPCWSTR           lpszDeviceClass
);

Parameter

lpfnUIDLLCallback

Zeiger auf eine Funktion, die die UI-DLL aufrufen kann, um mit der Dienstanbieter-DLL zu kommunizieren, um informationen zu erhalten, die zum Anzeigen des Dialogfelds und zum Senden der aktualisierten Konfiguration an den Dienstanbieter erforderlich sind.

dwDeviceID

Das zu konfigurierende Telefongerät.

hwndOwner

Ein Handle für ein übergeordnetes Fenster, in dem das Dialogfeldfenster platziert werden soll.

lpszDeviceClass

Ein Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die einen Geräteklassennamen identifiziert. Mit dieser Geräteklasse kann der Aufrufer einen bestimmten Unterbildschirm der Konfigurationsinformationen auswählen, die für diese Geräteklasse gelten. Wenn dieser Parameter NULL oder eine leere Zeichenfolge ist, wird das Konfigurationsdialogfeld der höchsten Ebene ausgewählt.

Rückgabewert

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

PHONEERR_BADDEVICEID, PHONEERR_NOMEM, PHONEERR_INUSE, PHONEERR_OPERATIONFAILED, PHONEERR_INVALPARAM, PHONEERR_OPERATIONUNAVAIL, PHONEERR_INVALDEVICECLASS, PHONEERR_RESOURCEUNAVAIL.

Hinweise

Mit dem Parameter lpszDeviceClass kann die Anwendung einen bestimmten Unterbildschirm der Konfigurationsinformationen auswählen, die für die Geräteklasse gelten, an der der Benutzer interessiert ist. Die zulässigen Zeichenfolgen sind identisch mit denen für TSPI_phoneGetID.

Wenn das Telefon z. B. die Comm-API unterstützt, bewirkt die Übergabe von comm/datamodem als lpszDeviceClass , dass der Anbieter die Parameter anzeigt, die sich speziell auf Comm beziehen (oder zumindest am entsprechenden Punkt in einer Konfigurationsdialogfeldkette mit mehreren Ebenen beginnt, sodass der Benutzer nicht suchen muss, um die gewünschten Parameter zu finden). Der szDeviceClass-Parameter sollte "tapi/phone", "" oder NULL lauten, damit der Anbieter die Konfiguration der höchsten Ebene für das Telefon anzeigt.

Anforderungen

Weitere Informationen

PHONECAPS

TSPI_phoneGetID