Fungsi CapabilitiesRequestAndCapabilitiesReply (lowlevelmonitorconfigurationapi.h)

Peringatan

Fungsi konfigurasi monitor fisik berfungsi menggunakan standar VESA Monitor Control Command Set (MCCS) melalui antarmuka I²C. Banyak monitor tidak sepenuhnya menerapkan standar tersebut; sehingga penggunaan Anda atas perintah ini dapat mengakibatkan perilaku monitor yang tidak terdefinisi. Kami tidak merekomendasikan penggunaan fungsi-fungsi ini untuk monitor arbitrer tanpa memvalidasi secara fisik bahwa fungsi tersebut berfungsi seperti yang dimaksudkan.

Mengambil string yang menjelaskan kemampuan monitor.

Sintaks

_BOOL CapabilitiesRequestAndCapabilitiesReply(
  [in]  HANDLE hMonitor,
  [out] LPSTR  pszASCIICapabilitiesString,
  [in]  DWORD  dwCapabilitiesStringLengthInCharacters
);

Parameter

[in] hMonitor

Tangani ke monitor fisik. Untuk mendapatkan handel monitor, panggil GetPhysicalMonitorsFromHMONITOR atau GetPhysicalMonitorsFromIDirect3DDevice9.

[out] pszASCIICapabilitiesString

Penunjuk ke buffer yang menerima string kemampuan monitor. Pemanggil harus mengalokasikan buffer ini. Untuk mendapatkan ukuran string, panggil GetCapabilitiesStringLength. String kemampuan selalu merupakan string ASCII. Buffer harus menyertakan ruang untuk karakter null yang mengakhiri.

[in] dwCapabilitiesStringLengthInCharacters

Ukuran pszASCIICapabilitiesString dalam karakter, termasuk karakter null yang mengakhiri.

Nilai kembali

Jika fungsi berhasil, nilai yang dikembalikan adalah TRUE. Jika fungsi gagal, nilai yang dikembalikan adalah FALSE. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError.

Keterangan

Fungsi ini sesuai dengan perintah "Permintaan Kemampuan & Kapabilitas" dari standar Antarmuka Perintah Saluran Data Tampilan (DDC/CI). Untuk informasi selengkapnya tentang string kemampuan, lihat standar DDC/CI.

Fungsi ini biasanya kembali dengan cepat, tetapi kadang-kadang bisa memakan waktu beberapa detik untuk diselesaikan.

Anda dapat memperbarui string kemampuan monitor dengan menambahkan direktif AddReg ke file INF monitor. Tambahkan kunci registri bernama "CapabilitiesString" ke kunci driver monitor. Nilai kunci registri adalah string kemampuan. Jenis data registri REG_SZ.

HKR,,"CapabilitiesString",0x00000000,"updated capabilities string"

Peringatan Jangan ubah file INF monitor kecuali Anda terbiasa dengan tata letak file INF dan juga memahami standar DDC/CI.

 

Contoh

DWORD cchStringLength = 0;
BOOL bSuccess = 0;
LPSTR szCapabilitiesString = NULL;

// Get the length of the string.
bSuccess = GetCapabilitiesStringLength(
   hPhysicalMonitor, // Handle to the monitor.
   &cchStringLength
   );

if (bSuccess)
{
    // Allocate the string buffer.
    LPSTR szCapabilitiesString = (LPSTR)malloc(cchStringLength);
    if (szCapabilitiesString != NULL)
    {
        // Get the capabilities string.
        bSuccess = CapabilitiesRequestAndCapabilitiesReply(
            hPhysicalMonitor,
            szCapabilitiesString,
            cchStringLength
            );

        // Free the string buffer.
        free(szCapabilitiesString);
    }
}

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	lowlevelmonitorconfigurationapi.h
Pustaka	Dxva2.lib
DLL	Dxva2.dll

Lihat juga

Memantau Fungsi Konfigurasi