Funzione IddCxMonitorQueryHardwareCursor3 (iddcx.h)

Articolo
02/29/2024

Un driver di visualizzazione indiretto chiama IddCxMonitorQueryHardwareCursor3 per recuperare le informazioni correnti sul cursore hardware per il monitoraggio specificato. Questa versione della funzione aggiunge il livello bianco SDR che un driver deve applicare al cursore se il monitor è in modalità HDR.

Sintassi

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

Parametri

MonitorObject

[in] Oggetto IDDCX_MONITOR che è l'handle del contesto del sistema operativo del monitoraggio creato da IddCxMonitorCreate.

pInArgs

Puntatore a una struttura IDARG_IN_QUERY_HWCURSOR contenente gli argomenti di input di questa funzione.

pOutArgs

Puntatore a una struttura IDARG_OUT_QUERY_HWCURSOR3 in cui vengono restituite le informazioni correnti sul cursore hardware del monitor.

Valore restituito

IddCxMonitorQueryHardwareCursor2 restituisce STATUS_SUCCESS al completamento; in caso contrario restituisce un codice di errore NTSTATUS appropriato. Un codice di errore di STATUS_GRAPHICS_PATH_NOT_IN_TOPOLOGY è un errore temporaneo che indica che MonitorObject non è attualmente in un percorso attivo.

Commenti

IddCxMonitorQueryHardwareCursor3 recupera le informazioni correnti sul cursore hardware per il monitoraggio specificato e lo inserisce nel buffer fornito dal chiamante a cui punta pOutArgs . Questa funzione è molto simile a IddCxMonitorQueryHardwareCursor2, ma fornisce anche il valore del livello bianco SDR. Il livello di bianco SDR è necessario perché tutte le immagini del cursore sono in formato SDR e il driver deve assicurarsi che vengano visualizzate con la luminosità corretta.

Per altre informazioni sul supporto HDR, vedi Aggiornamenti di IddCx versione 1.10.