Metodo IDirect3D9ExOverlayExtension::CheckDeviceOverlayType (d3d9.h)

Articolo
08/23/2023

Esegue una query sulle funzionalità hardware di sovrimpressione di un dispositivo Direct3D.

Sintassi

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
);

Parametri

[in] Adapter

Numero ordinale che indica l'adattatore di visualizzazione. D3DADAPTER_DEFAULT è sempre la scheda di visualizzazione primaria.

[in] DevType

Specifica il tipo di dispositivo Direct3D come membro del tipo enumerato D3DDEVTYPE .

[in] OverlayWidth

Larghezza della sovrimpressione da creare, in pixel.

[in] OverlayHeight

Altezza della sovrimpressione da creare, in pixel.

[in] OverlayFormat

Formato della superficie della sovrimpressione.

[in] pDisplayMode

Puntatore a una struttura D3DDISPLAYMODEEX che specifica la modalità di visualizzazione che verrà utilizzata. Se questo parametro è NULL, viene utilizzata la modalità di visualizzazione corrente.

[in] DisplayRotation

Specifica la modalità di rotazione dello schermo come membro del tipo enumerato D3DDISPLAYROTATION .

[out] pOverlayCaps

Puntatore a una struttura D3DOVERLAYCAPS . Se il driver supporta le impostazioni di sovrimpressione specificate nei parametri di input, il metodo riempie questa struttura con le funzionalità dell'hardware di sovrimpressione.

Valore restituito

Questo metodo può restituire uno di questi valori.

Codice restituito	Descrizione
D3DERR_INVALIDCALL	Parametro non valido o il dispositivo non supporta la sovrimpressione hardware.
D3DERR_UNSUPPORTEDOVERLAY	Il dispositivo non supporta la sovrimpressione per la dimensione o la modalità di visualizzazione specificata.
D3DERR_UNSUPPORTEDOVERLAYFORMAT	Il dispositivo non supporta la sovrimpressione per il formato di superficie specificato.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	d3d9.h

Vedi anche

Supporto della sovrimpressione hardware

IDirect3D9ExOverlayExtension

Condividi tramite