Função IddCxMonitorQueryHardwareCursor3 (iddcx.h)

Artigo
03/01/2024

Um driver de exibição indireto chama IddCxMonitorQueryHardwareCursor3 para recuperar as informações atuais do cursor de hardware para o monitor especificado. Essa versão de função adiciona o nível de branco SDR que um driver deve aplicar ao cursor se o monitor estiver em um modo HDR.

Sintaxe

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

Parâmetros

MonitorObject

[in] Um objeto IDDCX_MONITOR que é o identificador de contexto do sistema operacional do monitor criado por IddCxMonitorCreate.

pInArgs

Ponteiro para uma estrutura IDARG_IN_QUERY_HWCURSOR que contém os argumentos de entrada dessa função.

pOutArgs

Ponteiro para uma estrutura IDARG_OUT_QUERY_HWCURSOR3 na qual as informações atuais do cursor de hardware do monitor são retornadas.

Retornar valor

IddCxMonitorQueryHardwareCursor2 retorna STATUS_SUCCESS após o sucesso; caso contrário, retornará um código de erro NTSTATUS apropriado. Um código de erro de STATUS_GRAPHICS_PATH_NOT_IN_TOPOLOGY é um erro transitório que indica que o MonitorObject não está atualmente em um caminho ativo.

Comentários

IddCxMonitorQueryHardwareCursor3 recupera as informações atuais do cursor de hardware para o monitor especificado e as coloca no buffer fornecido pelo chamador para o qual pOutArgs aponta. Essa função é muito semelhante a IddCxMonitorQueryHardwareCursor2, mas também fornece o valor de nível branco SDR. O nível de branco SDR é necessário porque todas as imagens de cursor estão no formato SDR e o driver precisa garantir que elas sejam exibidas com o brilho correto.

Para obter mais informações sobre o suporte ao HDR, consulte Atualizações do IddCx versão 1.10.