Fonction IddCxMonitorQueryHardwareCursor3 (iddcx.h)

Article
02/29/2024

Un pilote d’affichage indirect appelle IddCxMonitorQueryHardwareCursor3 pour récupérer les informations actuelles du curseur matériel pour le moniteur spécifié. Cette version de fonction ajoute le niveau de blanc SDR qu’un pilote doit appliquer au curseur si le moniteur est en mode HDR.

Syntaxe

HRESULT IddCxMonitorQueryHardwareCursor3(
  IDDCX_MONITOR                 MonitorObject,
  const IDARG_IN_QUERY_HWCURSOR *pInArgs,
  IDARG_OUT_QUERY_HWCURSOR3     *pOutArgs
);

Paramètres

MonitorObject

[in] Objet IDDCX_MONITOR qui est le handle de contexte du système d’exploitation du moniteur créé par IddCxMonitorCreate.

pInArgs

Pointeur vers une structure IDARG_IN_QUERY_HWCURSOR contenant les arguments d’entrée de cette fonction.

pOutArgs

Pointeur vers une structure de IDARG_OUT_QUERY_HWCURSOR3 dans laquelle les informations actuelles du curseur matériel du moniteur sont retournées.

Valeur retournée

IddCxMonitorQueryHardwareCursor2 retourne STATUS_SUCCESS en cas de réussite ; sinon, il retourne un code d’erreur NTSTATUS approprié. Un code d’erreur de STATUS_GRAPHICS_PATH_NOT_IN_TOPOLOGY est une erreur temporaire indiquant que monitorObject n’est pas actuellement dans un chemin actif.

Remarques

IddCxMonitorQueryHardwareCursor3 récupère les informations actuelles du curseur matériel pour le moniteur spécifié et les place dans la mémoire tampon fournie par l’appelant vers laquelle pOutArgs pointe. Cette fonction est très similaire à IddCxMonitorQueryHardwareCursor2, mais fournit également la valeur de niveau blanc SDR. Le niveau de blanc SDR est requis, car toutes les images de curseur sont au format SDR et le pilote doit s’assurer qu’elles sont affichées à la luminosité correcte.

Pour plus d’informations sur la prise en charge HDR, consultez Mises à jour d’IddCx version 1.10.