TSPI_lineGetAddressCaps-Funktion (tspi.h)
Die TSPI_lineGetAddressCaps-Funktion fragt die angegebene Adresse auf dem angegebenen Leitungsgerät ab, um die Telefoniefunktionen zu bestimmen.
Syntax
LONG TSPIAPI TSPI_lineGetAddressCaps(
DWORD dwDeviceID,
DWORD dwAddressID,
DWORD dwTSPIVersion,
DWORD dwExtVersion,
LPLINEADDRESSCAPS lpAddressCaps
);
Parameter
dwDeviceID
Das Zeilengerät, das die abzufragende Adresse enthält.
dwAddressID
Die Adresse auf dem angegebenen Zeilengerät, dessen Funktionen abgefragt werden sollen. Ein Adressbezeichner ist einer Adresse dauerhaft zugeordnet. Der Bezeichner bleibt über Betriebssystemupgrades hinweg konstant. Dieser Parameter wird nicht von TAPI überprüft, wenn diese Funktion aufgerufen wird.
dwTSPIVersion
Die Versionsnummer des zu verwendenden Telefonie-SPI. Das Wort mit hoher Ordnung enthält die Hauptversionsnummer; das Wort mit niedriger Reihenfolge enthält die Nebenversionsnummer.
dwExtVersion
Die Versionsnummer der zu verwendenden dienstanbieterspezifischen Erweiterungen. Diese Zahl ist 0, wenn keine gerätespezifischen Erweiterungen verwendet werden sollen. Andernfalls enthält das hochgeordnete Wort die Hauptversionsnummer; das Wort mit niedriger Reihenfolge enthält die Nebenversionsnummer. Dieser Parameter wird nicht von TAPI überprüft, wenn diese Funktion aufgerufen wird.
lpAddressCaps
Ein Zeiger auf eine variabel dimensionierte Struktur vom Typ LINEADDRESSCAPS. Nach erfolgreichem Abschluss der Anforderung wird diese Struktur mit Informationen zu Adressfunktionen gefüllt.
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:
LINEERR_INCOMPATIBLEAPIVERSION, LINEERR_NOMEM, LINEERR_INCOMPATIBLEEXTVERSION, LINEERR_OPERATIONUNAVAIL, LINEERR_INVALADDRESSID, LINEERR_OPERATIONFAILED, LINEERR_NODRIVER, LINEERR_RESOURCEUNAVAIL.
Hinweise
Die von einem bestimmten Treiber unterstützten Zeilengerätebezeichner werden sequenziell nummeriert, beginnend mit dem Wert von dwLineDeviceIDBase , der an die TSPI_providerInit-Funktion übergeben wird.
Der Dienstanbieter füllt alle Member der LINEADDRESSCAPS-Datenstruktur aus, mit Ausnahme von dwTotalSize, das von TAPI ausgefüllt wird. Der Dienstanbieter darf den dwTotalSize-Member nicht überschreiben.
Nachdem der Dienstanbieter von der funktion TSPI_lineGetAddressCaps zurückgegeben hat, legt TAPI die dwCallInfoStates - und dwCallStates-Member der LINEADDRESSCAPS-Struktur wie folgt fest:
LINEADDRESSCAPS.dwCallInfoStates |=
LINECALLINFOSTATE_NUMOWNERINCR |
LINECALLINFOSTATE_NUMOWNERDECR |
LINECALLINFOSTATE_NUMMONITORS;
LINEADDRESSCAPS.dwCallStates |= LINECALLSTATE_UNKNOWN;
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tspi.h |