Funzione CapabilitiesRequestAndCapabilitiesReply (lowlevelmonitorconfigurationapi.h)

Articolo
02/28/2024

Avviso

Le funzioni di configurazione del monitoraggio fisico funzionano usando lo standard VESA Monitor Control Set (MCCS) su un'interfaccia I²C. Molti monitor non implementano completamente tale standard; pertanto l'uso di questi comandi potrebbe comportare un comportamento di monitoraggio non definito. Non è consigliabile usare queste funzioni per monitoraggi arbitrari senza convalidare fisicamente che funzionino come previsto.

Recupera una stringa che descrive le funzionalità di un monitoraggio.

Sintassi

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

Parametri

[in] hMonitor

Gestire un monitoraggio fisico. Per ottenere l'handle di monitoraggio, chiamare GetPhysicalMonitorsFromHMONITOR o GetPhysicalMonitorsFromIDirect3DDevice9.

[out] pszASCIICapabilitiesString

Puntatore a un buffer che riceve la stringa delle funzionalità del monitoraggio. Il chiamante deve allocare questo buffer. Per ottenere le dimensioni della stringa, chiamare GetCapabilitiesStringLength. La stringa di funzionalità è sempre una stringa ASCII. Il buffer deve includere spazio per il carattere Null terminante.

[in] dwCapabilitiesStringLengthInCharacters

Dimensioni di pszASCIICapabilitiesString in caratteri, incluso il carattere null terminante.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE. Se la funzione ha esito negativo, il valore restituito è FALSE. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

Questa funzione corrisponde al comando "Capabilities Request & Capabilities Reply" dello standard Display Data Channel Command Interface (DDC/CI). Per altre informazioni sulla stringa di funzionalità, vedere lo standard DDC/CI.

Questa funzione restituisce in genere rapidamente, ma a volte può richiedere diversi secondi per completare.

È possibile aggiornare la stringa delle funzionalità di un monitoraggio aggiungendo una direttiva AddReg al file INF del monitoraggio. Aggiungere una chiave del Registro di sistema denominata "CapabilitiesString" alla chiave del driver del monitoraggio. Il valore della chiave del Registro di sistema è la stringa di funzionalità. Il tipo di dati del Registro di sistema è REG_SZ.

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

Avviso Non modificare il file INF di un monitoraggio, a meno che non si abbia familiarità con il layout dei file INF e non si comprenda lo standard DDC/CI.

Esempio


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);
    }
}

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	lowlevelmonitorconfigurationapi.h
Libreria	Dxva2.lib
DLL	Dxva2.dll

Vedi anche

Monitorare le funzioni di configurazione

Condividi tramite