estrutura DXGK_FLIPCAPS (d3dkmddi.h)

Artigo
05/26/2023

A estrutura DXGK_FLIPCAPS identifica as funcionalidades de inversão do driver de miniporto de exibição que o driver fornece por meio de uma chamada para sua função DxgkDdiQueryAdapterInfo .

Sintaxe

typedef struct _DXGK_FLIPCAPS {
  union {
    struct {
      UINT FlipOnVSyncWithNoWait : 1;
      UINT FlipOnVSyncMmIo : 1;
      UINT FlipInterval : 1;
      UINT FlipImmediateMmIo : 1;
      UINT FlipIndependent : 1;
      UINT DdiPresentForIFlip : 1;
      UINT FlipImmediateOnHSync : 1;
#if ...
      UINT Reserved : 25;
#elif
      UINT Reserved : 27;
#else
      UINT Reserved : 28;
#endif
    };
    UINT Value;
  };
} DXGK_FLIPCAPS;

Membros

FlipOnVSyncWithNoWait

Um valor UINT que especifica se o driver dá suporte ao agendamento de um comando flip que entrará em vigor no próximo período de novo rastreamento vertical (sincronização vertical) sem fazer com que o pipeline de gráficos seja interrompido até que essa sincronização vertical ocorra. Ou seja, o pipeline gráfico deve continuar imediatamente após o driver gravar o endereço físico da superfície invertida em registros pendentes de inversão no hardware. Embora a maioria dos hardwares use uma profundidade de um registro pendente de inversão, se o hardware usar mais de um registro pendente de inversão, o driver deverá especificar o número no membro MaxQueuedFlipOnVSync da estrutura DXGK_DRIVERCAPS .

Se FlipOnVSyncWithNoWait estiver definido como 1 (TRUE), o driver oferecerá suporte a esse mecanismo. Se FlipOnVSyncWithNoWait estiver definido como 0 (FALSE), o driver não oferecerá suporte a esse mecanismo. Ou seja, o pipeline de gráficos deve aguardar até que a próxima sincronização vertical ocorra após o agendamento de um comando de inversão para entrar em vigor na próxima sincronização vertical.

Definir esse membro é equivalente a definir o primeiro bit do membro Value de 32 bits (0x00000001).

FlipOnVSyncMmIo

Um valor UINT que especifica se o driver dá suporte a uma inversão baseada em MMIO (E/S mapeada na memória) que entra em vigor na próxima sincronização vertical. Para dar suporte a esse tipo de inversão, o driver de miniporta de exibição deve dar suporte às seguintes operações:

Nenhuma geração de um buffer DMA para passar uma chamada para sua função DxgkDdiPresent (ou seja, NULL é passado no membro pDmaBuffer da estrutura DXGKARG_PRESENT ).
Um inverter uma chamada para sua função DxgkDdiSetVidPnSourceAddress no nível de solicitação de interrupção do dispositivo (DIRQL). Na chamada para DxgkDdiSetVidPnSourceAddress, o driver deve programar o DAC (conversor digital para analógico) e usar o valor no membro PrimaryAddress da estrutura DXGKARG_SETVIDPNSOURCEADDRESS para iniciar a verificação. Após a sincronização vertical, o driver deve notificar o agendador de GPU para relatar o endereço de verificação efetivo chamando a função DxgkCbNotifyInterrupt com o valor DXGK_INTERRUPT_CRTC_VSYNC definido no membro InterruptType da estrutura DXGKARGCB_NOTIFY_INTERRUPT_DATA . Em seguida, o driver deve chamar a função DxgkCbNotifyDpc para executar a maior parte do processamento de verificação.

FlipInterval

Um valor UINT que especifica se o driver dá suporte ao agendamento de um comando flip para entrar em vigor após duas, três ou quatro sincronizações verticais. Independentemente de o driver dar suporte a um intervalo de inversão de dois ou mais, o driver deve dar suporte a uma inversão imediata e um intervalo de inversão de um.

Definir esse membro é equivalente a definir o terceiro bit do membro Value de 32 bits (0x00000004).

FlipImmediateMmIo

Um valor UINT que especifica se o driver dá suporte a uma inversão imediata baseada em MMIO (E/S mapeada na memória). Esse tipo de inversão entra em vigor imediatamente após uma chamada para a função DxgkDdiSetVidPnSourceAddress do driver sem esperar que a próxima sincronização vertical ocorra.

Definir esse membro é equivalente a definir o quarto bit do membro Value de 32 bits (0x00000008).

Com suporte a partir do Windows 7.

FlipIndependent

Um valor UINT que especifica se o driver dá suporte a uma inversão independente. Os drivers WDDM 1.3 e posteriores devem definir esse membro como 1.

Em uma inversão independente, o sistema operacional tenta ignorar uma chamada presente no modo de usuário do DWM (Gerenciador de Janelas da Área de Trabalho) e inverte para o buffer de fundo do aplicativo chamando DxgkDdiPresent e DxgkDdiSetVidPnSourceAddress em modelos de apresentação de sobreposição multiplane e Flip Direto.

Observe que haverá casos em que uma chamada presente no modo de usuário dwm é feita mesmo quando FlipIndependent é definido. Seu driver ainda deve lidar com esses casos.

Definir esse membro é equivalente a definir o quinto bit do membro Value de 32 bits (0x00000010).

Suporte começando com Windows 8.1.

DdiPresentForIFlip

FlipImmediateOnHSync

Reserved

Esse membro é reservado e deve ser definido como zero. Definir esse membro como zero é equivalente a definir os 27 bits restantes (0xFFFFFFE0) do membro Value de 32 bits como zeros.

Esse membro é reservado e deve ser definido como zero. Definir esse membro como zero é equivalente a definir os 28 bits restantes (0xFFFFFFF0) do membro Value de 32 bits como zeros.

Value

Um membro na união que DXGK_FLIPCAPS contém que pode conter um valor de 32 bits que identifica as funcionalidades de inversão.