Metode ITLegacyAddressMediaControl::GetDevConfig (tapi3if.h)

Artikel
03/02/2024

Metode GetDevConfig mengembalikan struktur data buram. Konten yang tepat khusus untuk penyedia layanan dan kelas perangkat. Struktur data menentukan konfigurasi perangkat yang terkait dengan perangkat baris tertentu. Misalnya, konten struktur ini dapat menentukan laju data, format karakter, skema modulasi, dan pengaturan protokol kontrol kesalahan untuk perangkat datamodem yang terkait dengan baris.

Sintaks

HRESULT GetDevConfig(
  [in]  BSTR  pDeviceClass,
  [out] DWORD *pdwSize,
  [out] BYTE  **ppDeviceConfig
);

Parameter

[in] pDeviceClass

Pointer ke BSTR yang berisi kelas perangkat TAPI tempat informasi konfigurasi diperlukan.

[out] pdwSize

Penunjuk ke ukuran array konfigurasi.

[out] ppDeviceConfig

Penunjuk ke array byte yang berisi informasi konfigurasi perangkat.

Mengembalikan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode	Deskripsi
S_OK	Metode berhasil.
E_POINTER	Parameter pDeviceClass, pdwSize, atau ppDeviceConfig bukan penunjuk yang valid.
E_OUTOFMEMORY	Tidak ada cukup memori untuk melakukan operasi.

Keterangan

Metode ini adalah pembungkus COM untuk fungsi LineGetDevConfig TAPI 2.1.

GetID harus dilakukan sebelum memanggil metode ini.

Aplikasi harus menggunakan SysAllocString untuk mengalokasikan memori untuk parameter pDeviceClass dan menggunakan SysFreeString untuk membebaskan memori ketika variabel tidak lagi diperlukan.

Aplikasi harus memanggil fungsi CoTaskMemFree untuk membebaskan memori yang dialokasikan untuk parameter ppDeviceConfig .

TAPI 2.1 Cross-References: lineGetDevConfig, lineSetDevConfig

Persyaratan

Persyaratan	Nilai
Target Platform	Windows
Header	tapi3if.h (termasuk Tapi3.h)
Pustaka	Uuid.lib
DLL	Tapi3.dll

Lihat juga

ITLegacyAddressMediaControl

ITLegacyCallMediaControl

SetDevConfig

Bagikan melalui