estrutura D3D10DDIARG_CALCPRIVATEDEVICESIZE (d3d10umddi.h)

Artigo
02/06/2025

A estrutura D3D10DDIARG_CALCPRIVATEDEVICESIZE descreve os parâmetros que o driver de exibição do modo de usuário usa para calcular o tamanho de um bloco de memória que o driver precisa para armazenar dados acessados com frequência.

Sintaxe

typedef struct D3D10DDIARG_CALCPRIVATEDEVICESIZE {
  [in] UINT Interface;
  [in] UINT Version;
  [in] UINT Flags;
} D3D10DDIARG_CALCPRIVATEDEVICESIZE;

Membros

[in] Interface

A versão da interface do Microsoft Direct3D. Os 16 bits altos armazenam o número de lançamento principal (como 10, 11 e assim por diante); os 16 bits baixos armazenam o número de versão secundária (como 0, 1, 2 e assim por diante). O número de versão secundária será aumentado quando uma alteração na interface for lançada.

[in] Version

Um número que o driver pode usar para identificar quando o runtime do Direct3D foi criado. Os 16 bits altos representam o número de build; os 16 bits baixos representam o número de revisão.

O driver é necessário apenas para monitorar os 16 bits altos. O driver deve garantir que a versão de build do runtime passada seja maior ou igual à versão de build atual do driver. O driver deve retornar uma falha de sua função CalcPrivateDeviceSize se a versão de build passada for incompatível.

[in] Flags

Um OR bit a bit válido de valores de sinalizador que identificam como criar um dispositivo de renderização. O runtime do Direct3D dá suporte aos seguintes sinalizadores:

D3D10DDI_CREATEDEVICE_FLAG_DISABLE_EXTRA_THREAD_CREATION (0x1)

Se esse sinalizador estiver definido, o driver de exibição do modo de usuário não deverá executar vários threads simultaneamente quando processar chamadas para suas funções do runtime do Direct3D. Normalmente, um driver pode iniciar e executar vários threads para processar operações mais rapidamente, a menos que o sinalizador de D3D10DDI_CREATEDEVICE_FLAG_DISABLE_EXTRA_THREAD_CREATION esteja definido.

D3D11DDI_CREATEDEVICE_FLAG_SINGLETHREADED (0x10)

Com suporte no Windows 7 e versões posteriores.

Esse sinalizador informa ao driver de exibição do modo de usuário que o aplicativo está em thread único. O runtime do Direct3D versão 11 permite que vários threads de aplicativo insiram o driver se o driver permitir esse modo de operação. No entanto, nem todos os aplicativos podem executar vários threads. Se esse sinalizador estiver definido, o driver não espera que vários threads insiram e sejam executados simultaneamente. O driver poderá evitar a sincronização se esse sinalizador estiver definido.

O sinalizador definido na máscara 0xE do membro Flags

Com suporte no Windows 7 e versões posteriores.

Esse sinalizador representa o nível de pipeline 3D que o driver deve dar suporte para o dispositivo de exibição. O driver usa a seguinte constante e macros para extrair um dos valores da enumeração D3D11DDI_3DPIPELINELEVEL que representam o nível de pipeline 3D para dar suporte. O valor no membro Flags é formatado como o membro caps da estrutura de D3D11DDI_3DPIPELINESUPPORT_CAPS.

#define D3D11DDI_CREATEDEVICE_FLAG_3DPIPELINESUPPORT_SHIFT (0x1)
#define D3D11DDI_CREATEDEVICE_FLAG_3DPIPELINESUPPORT_MASK (0x7 << D3D11DDI_CREATEDEVICE_FLAG_3DPIPELINESUPPORT_SHIFT)
#define D3D11DDI_EXTRACT_3DPIPELINELEVEL_FROM_FLAGS( Flags ) \
    ((D3D11DDI_3DPIPELINELEVEL)(((Flags) & D3D11DDI_CREATEDEVICE_FLAG_3DPIPELINESUPPORT_MASK) >> \
    D3D11DDI_CREATEDEVICE_FLAG_3DPIPELINESUPPORT_SHIFT))

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows Vista e versões posteriores dos sistemas operacionais Windows.
cabeçalho	d3d10umddi.h (inclua D3d10umddi.h)

Consulte também

CalcPrivateDeviceSize

Compartilhar via