Método IDirect3D9ExOverlayExtension::CheckDeviceOverlayType (d3d9.h)

Artigo
02/29/2024

Consulta os recursos de hardware de sobreposição de um dispositivo Direct3D.

Sintaxe

HRESULT CheckDeviceOverlayType(
  [in]  UINT               Adapter,
  [in]  D3DDEVTYPE         DevType,
  [in]  UINT               OverlayWidth,
  [in]  UINT               OverlayHeight,
  [in]  D3DFORMAT          OverlayFormat,
  [in]  D3DDISPLAYMODEEX   *pDisplayMode,
  [in]  D3DDISPLAYROTATION DisplayRotation,
  [out] D3DOVERLAYCAPS     *pOverlayCaps
);

Parâmetros

[in] Adapter

Um número ordinal que indica o adaptador de exibição. D3DADAPTER_DEFAULT é sempre o adaptador de exibição primário.

[in] DevType

Especifica o tipo de dispositivo Direct3D como um membro do D3DDEVTYPE tipo enumerado.

[in] OverlayWidth

A largura da sobreposição a ser criada, em pixels.

[in] OverlayHeight

A altura da sobreposição a ser criada, em pixels.

[in] OverlayFormat

O formato de superfície da sobreposição.

[in] pDisplayMode

Um ponteiro para uma estrutura D3DDISPLAYMODEEX que especifica o modo de exibição que será usado. Se esse parâmetro for NULL, o modo de exibição atual será assumido.

[in] DisplayRotation

Especifica o modo de rotação de exibição como um membro do tipo enumerado D3DDISPLAYROTATION .

[out] pOverlayCaps

Um ponteiro para uma estrutura D3DOVERLAYCAPS . Se o driver der suporte às configurações de sobreposição especificadas nos parâmetros de entrada, o método preencherá essa estrutura com os recursos do hardware de sobreposição.

Retornar valor

Esse método pode retornar um desses valores.

Código de retorno	Descrição
D3DERR_INVALIDCALL	Parâmetro inválido ou o dispositivo não dá suporte à sobreposição de hardware.
D3DERR_UNSUPPORTEDOVERLAY	O dispositivo não dá suporte à sobreposição para o tamanho ou modo de exibição especificado.
D3DERR_UNSUPPORTEDOVERLAYFORMAT	O dispositivo não dá suporte à sobreposição para o formato de superfície especificado.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	d3d9.h

Confira também

Suporte à sobreposição de hardware

IDirect3D9ExOverlayExtension

Compartilhar via