Fonction CapabilitiesRequestAndCapabilitiesReply (lowlevelmonitorconfigurationapi.h)

Article
03/04/2024

Avertissement

Les fonctions de configuration du moniteur physique fonctionnent à l’aide de la norme VESA Monitor Control Command Set (MCCS) sur une interface I²C. De nombreux moniteurs n’implémentent pas entièrement cette norme ; votre utilisation de ces commandes peut entraîner un comportement de surveillance non défini. Nous vous déconseillons d’utiliser ces fonctions pour les moniteurs arbitraires sans valider physiquement qu’elles fonctionnent comme prévu.

Récupère une chaîne décrivant les fonctionnalités d’un moniteur.

Syntaxe

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

Paramètres

[in] hMonitor

Gérer sur un moniteur physique. Pour obtenir le handle du moniteur, appelez GetPhysicalMonitorsFromHMONITOR ou GetPhysicalMonitorsFromIDirect3DDevice9.

[out] pszASCIICapabilitiesString

Pointeur vers une mémoire tampon qui reçoit la chaîne de fonctionnalités du moniteur. L’appelant doit allouer cette mémoire tampon. Pour obtenir la taille de la chaîne, appelez GetCapabilitiesStringLength. La chaîne de fonctionnalités est toujours une chaîne ASCII. La mémoire tampon doit inclure de l’espace pour le caractère null de fin.

[in] dwCapabilitiesStringLengthInCharacters

Taille de pszASCIICapabilitiesString en caractères, y compris le caractère null de fin.

Valeur retournée

Si la fonction réussit, la valeur de retour est TRUE. Si la fonction échoue, la valeur de retour est FALSE. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Cette fonction correspond à la commande « Demande de fonctionnalités & réponse aux fonctionnalités » de la norme Display Data Channel Command Interface (DDC/CI). Pour plus d’informations sur la chaîne de fonctionnalités, reportez-vous à la norme DDC/CI.

Cette fonction retourne généralement rapidement, mais elle peut parfois prendre plusieurs secondes.

Vous pouvez mettre à jour la chaîne de fonctionnalités d’un moniteur en ajoutant une directive AddReg au fichier INF du moniteur. Ajoutez une clé de Registre nommée « CapabilitiesString » à la clé de pilote du moniteur. La valeur de la clé de Registre est la chaîne de fonctionnalités. Le type de données du Registre est REG_SZ.

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

Avertissement Ne modifiez pas le fichier INF d’un moniteur, sauf si vous êtes familiarisé avec la disposition des fichiers INF et que vous comprenez également la norme DDC/CI.

Exemples


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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	lowlevelmonitorconfigurationapi.h
Bibliothèque	Dxva2.lib
DLL	Dxva2.dll

Voir aussi

Surveiller les fonctions de configuration

Partager via