ITLegacyAddressMediaControl::GetDevConfig-Methode (tapi3if.h)
Die GetDevConfig-Methode gibt eine undurchsichtige Datenstruktur zurück. Die genauen Inhalte sind spezifisch für den Dienstanbieter und die Geräteklasse. Die Datenstruktur gibt die Konfiguration eines Geräts an, das einem bestimmten Leitungsgerät zugeordnet ist. Der Inhalt dieser Struktur könnte beispielsweise Datenrate, Zeichenformat, Modulationsschemas und Fehlersteuerungsprotokolleinstellungen für ein datenmodem-Gerät angeben, das der Zeile zugeordnet ist.
Syntax
HRESULT GetDevConfig(
[in] BSTR pDeviceClass,
[out] DWORD *pdwSize,
[out] BYTE **ppDeviceConfig
);
Parameter
[in] pDeviceClass
Zeiger auf BSTR mit TAPI-Geräteklasse , für die Konfigurationsinformationen benötigt werden.
[out] pdwSize
Zeiger auf die Größe des Konfigurationsarrays.
[out] ppDeviceConfig
Zeiger auf ein Array von Bytes, das Informationen zur Gerätekonfiguration enthält.
Rückgabewert
Diese Methode kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Methode war erfolgreich. |
|
Der Parameter pDeviceClass, pdwSize oder ppDeviceConfig ist kein gültiger Zeiger. |
|
Zum Ausführen des Vorgangs ist nicht genügend Arbeitsspeicher vorhanden. |
Hinweise
Diese Methode ist ein COM-Wrapper für die Funktion LineGetDevConfig TAPI 2.1.
Die GetID muss vor dem Aufrufen dieser Methode ausgeführt werden.
Die Anwendung muss SysAllocString verwenden, um Arbeitsspeicher für den pDeviceClass-Parameter zuzuweisen und SysFreeString zum Freigeben des Arbeitsspeichers verwenden, wenn die Variable nicht mehr benötigt wird.
Die Anwendung muss die CoTaskMemFree-Funktion aufrufen, um den für den ppDeviceConfig-Parameter zugewiesenen Arbeitsspeicher freizugeben.
TAPI 2.1 Cross-References: lineGetDevConfig, lineSetDevConfig
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform | Windows |
| Kopfzeile | tapi3if.h (einschließlich Tapi3.h) |
| Bibliothek | Uuid.lib |
| DLL | Tapi3.dll |