Compartilhar via

IDDCX_ADAPTER_FLAGS enumeração (iddcx.h)

  • Artigo

IDDCX_ADAPTER_FLAGS especifica os sinalizadores de funcionalidade booliana para um adaptador de exibição indireto.

Syntax

typedef enum IDDCX_ADAPTER_FLAGS {
  IDDCX_ADAPTER_FLAGS_NONE = 0,
  IDDCX_ADAPTER_FLAGS_USE_SMALLEST_MODE = 0x1,
  IDDCX_ADAPTER_FLAGS_CAN_USE_MOVE_REGIONS = 0x2,
  IDDCX_ADAPTER_FLAGS_REMOTE_SESSION_DRIVER = 0x4,
  IDDCX_ADAPTER_FLAGS_PREFER_PHYSICALLY_CONTIGUOUS = 0x8,
  IDDCX_ADAPTER_FLAGS_REMOTE_ALL_CURSOR_POSITION = 0x10,
  IDDCX_ADAPTER_FLAGS_PREFER_PRECISE_PRESENT_REGIONS = 0x20,
  IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 = 0x40,
  IDDCX_ADAPTER_FLAGS_REMOTE_ALL_TARGET_MODES_MONITOR_COMPATIBLE = 0x80
} ;

Constantes

 
IDDCX_ADAPTER_FLAGS_NONE
Valor: 0
Indica que não há sinalizadores definidos para o adaptador.
IDDCX_ADAPTER_FLAGS_USE_SMALLEST_MODE
Valor: 0x1
O modelo de exibição indireto dá suporte automaticamente aos modos virtuais do sistema operacional, permitindo que o sistema operacional execute perfeitamente as alterações de modo usando o dimensionamento do DWM (Gerenciador de Janelas da Área de Trabalho) por quadro sem uma alteração no modo de exibição. Uma desvantagem ocorre quando um modo de área de trabalho menor é usado pelo usuário: a imagem da área de trabalho fornecida ao driver é maior que o tamanho da área de trabalho, desperdiçando assim a codificação e a largura de banda de transmissão.

Esse valor de enumeração informa ao sistema operacional para usar o menor tamanho de superfície da área de trabalho possível quando o modo de área de trabalho é alterado. Uma solução que tem sobrecarga de processamento grande ou largura de banda de transmissão limitada normalmente usa esse sinalizador para reduzir o tamanho da imagem da área de trabalho para processar o máximo possível.

Definir esse sinalizador resulta em uma alteração de modo sempre que a resolução da área de trabalho é alterada.
IDDCX_ADAPTER_FLAGS_CAN_USE_MOVE_REGIONS
Valor: 0x2
Esse sinalizador foi preterido a partir do IddCx v1.7. Os drivers ainda podem definir esse sinalizador para o IddCx 1.7 e superior, mas ele não terá efeito. Se um driver for projetado para ser executado no pré-IddCx 1.7 e definir esse sinalizador, esse driver deverá ter a lógica para processar as movimentações; caso contrário, os usuários verão problemas visuais ao executar em sistemas pré-IddCx 1.7.

Indica se o driver pode usar regiões de movimentação fornecidas pelo sistema operacional, além de sujo rects ao codificar a imagem. O driver só deve definir isso como TRUE se usar as regiões de movimentação porque o sistema operacional incorre em um custo ao gerar esses recursos adicionais. Se o driver definir isso como FALSE, o sistema operacional converterá todas as regiões de movimentação em sujo rects.
IDDCX_ADAPTER_FLAGS_REMOTE_SESSION_DRIVER
Valor: 0x4
Indica se o driver é um driver de sessão remoto que dá suporte a monitores de sessão remota, em vez de monitores de sessão do console. Um driver de sessão remota não pode dar suporte a monitores de sessão de console e um driver de sessão de console não pode dar suporte a monitores de sessão remota. Com suporte a partir do IddCx versão 1.4.
IDDCX_ADAPTER_FLAGS_PREFER_PHYSICALLY_CONTIGUOUS
Valor: 0x8
Indica que o driver prefere que a memória fisicamente contígua seja usada para buffers de cadeia de troca, permitindo que o driver examine diretamente os buffers sem a necessidade de uma cópia intermediária. Com suporte a partir do IddCx versão 1.6.
IDDCX_ADAPTER_FLAGS_REMOTE_ALL_CURSOR_POSITION
Valor: 0x10
Indica que o driver deseja receber todas as alterações de posição do cursor; ou seja, ele deseja receber a entrada do mouse injetada na sessão remota do cliente remoto e as movimentações processuais causadas por uma chamada à API de um aplicativo ou do sistema operacional no servidor.

Esse sinalizador só é válido quando combinado com IDDCX_ADAPTER_FLAGS_REMOTE_SESSION_DRIVER. IddCxAdapterInitAsync falhará se IDDCX_ADAPTER_FLAGS_REMOTE_ALL_CURSOR_POSITION estiver definido sem IDDCX_ADAPTER_FLAGS_REMOTE_SESSION_DRIVER.

Com suporte a partir do IddCx versão 1.7.
IDDCX_ADAPTER_FLAGS_PREFER_PRECISE_PRESENT_REGIONS
Valor: 0x20
Um driver que define esse sinalizador está solicitando que o sistema operacional acompanhe sujo regiões das atualizações da área de trabalho com mais precisão. Esse acompanhamento mais preciso tem uma pequena sobrecarga de uso da CPU, portanto, os drivers só devem definir esse sinalizador se regiões menores sujo forem benéficas para o driver.

Com suporte a partir do IddCx versão 1.8.
IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16
Indica que o driver pode processar superfícies de troca fp16 (ponto flutuante de meia precisão) IEEE. Um driver deve definir IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 mesmo para adaptadores que não dão suporte a HDR ou SDR WCG. O sistema operacional envia superfícies e modos hdr ou SDR WC para o driver quando a combinação certa de monitor, recursos de destino, configurações de O e assim por diante estão em vigor. Portanto, um driver que define IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 também deve dar suporte às funções IddCx versão 1.10 que permitem que isso aconteça. Um driver compatível com HDR10 deve ser capaz de:

* Recebimento e processamento de superfícies de formato FP16 em uma cadeia de troca.
* Aplicando o nível branco de SDR indicado aos cursores do mouse.

Os drivers de console também devem:

* Use a nova transformação de cor de matriz 3x4.
* Aceite e use metadados HDR.

Os drivers remotos também devem:

* Forneça a colorimetria e o nível branco de SDR quando necessário.

Com suporte a partir do IddCx versão 1.10. Consulte Observações.
IDDCX_ADAPTER_FLAGS_REMOTE_ALL_TARGET_MODES_MONITOR_COMPATIBLE
Valor: 0x80
Somente drivers remotos podem definir esse sinalizador.

Os drivers remotos podem usar IDDCX_ADAPTER_FLAGS_ALL_TARGET_MODES_MONITOR_COMPATIBLE para permitir que eles especifiquem modos de destino que não fazem parte de um descritor de monitor. Normalmente, o sistema operacional escolhe um modo com base em estar na lista do monitor e do modo de destino, relatado por meio de EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION ou EVT_IDD_CX_MONITOR_GET_DEFAULT_DESCRIPTION_MODES se nenhum descritor estiver disponível e a lista de modo de destino. Cenários remotos podem exigir modos que não estão no descritor. Em vez disso, o driver pode usar modos de destino para descrevê-los e indicar ao sistema operacional que eles não devem ser verificados nos modos de monitor.

Quando um driver remoto define esse sinalizador, ele indica que todos os modos de destino relatados em chamadas para EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 e IddCxMonitorUpdateModes2 têm a garantia de serem compatíveis com o monitor conectado no momento. Em seguida, o sistema operacional não chamará EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 ou EVT_IDD_CX_MONITOR_GET_DEFAULT_DESCRIPTION_MODES.

Com suporte a partir do IddCx versão 1.10. Consulte Observações.

Comentários

Para determinar se o sistema operacional aceita drivers configurando IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 ou IDDCX_ADAPTER_FLAGS_ALL_TARGET_MODES_MONITOR_COMPATIBLE, o driver deve usar a macro IDD_IS_FUNCTION_AVAILABLE para marcar para a presença de um dos DDIs da versão 1.10; por exemploIDD_IS_FUNCTION_AVAILABLE(IddCxSwapChainReleaseAndAcquireBuffer2). Essa macro é avaliada como TRUE em um sistema operacional com suporte v1.10 e false caso contrário. Consulte Atualizações para versões 1.10 e posteriores do IdDCx para obter mais informações.

Requisitos

Requisito Valor
Cabeçalho iddcx.h

Confira também

IDDCX_ADAPTER_CAPS

IddCxAdapterInitAsync