Metodo IDXGISwapChain::ResizeTarget (dxgi.h)

  • Articolo

Ridimensiona la destinazione di output.

Sintassi

HRESULT ResizeTarget(
  [in] const DXGI_MODE_DESC *pNewTargetParameters
);

Parametri

[in] pNewTargetParameters

Tipo: const DXGI_MODE_DESC*

Puntatore a una struttura DXGI_MODE_DESC che descrive la modalità, che specifica la nuova larghezza, altezza, formato e frequenza di aggiornamento della destinazione. Se il formato è DXGI_FORMAT_UNKNOWN, ResizeTarget usa il formato esistente. È consigliabile usare DXGI_FORMAT_UNKNOWN solo quando la catena di scambio è in modalità schermo intero perché questo metodo non è thread safe.

Valore restituito

Tipo: HRESULT

Restituisce un codice che indica l'esito positivo o l'errore. DXGI_STATUS_MODE_CHANGE_IN_PROGRESS viene restituito se si verifica una transizione in modalità schermo intero/finestra quando questa API viene chiamata. Vedere DXGI_ERROR per altri codici di errore DXGI.

Commenti

ResizeTarget ridimensiona la finestra di destinazione quando la catena di scambio è in modalità finestrata e modifica la modalità di visualizzazione nell'output di destinazione quando la catena di scambio è in modalità schermo intero. Di conseguenza, le app possono chiamare ResizeTarget per ridimensionare la finestra di destinazione (anziché un'cartella Microsoft Win32API, ad esempio SetWindowPos) senza conoscenza della modalità di visualizzazione della catena di scambio.

Se un'app di Windows Store chiama ResizeTarget, ha esito negativo con DXGI_ERROR_NOT_CURRENTLY_AVAILABLE.

Non è possibile chiamare ResizeTarget in una catena di scambio creata con IDXGIFactory2::CreateSwapChainForComposition.

Le app devono comunque chiamare IDXGISwapChain::ResizeBuffers dopo aver chiamato ResizeTarget perché solo ResizeBuffers può modificare i buffer indietro. Tuttavia, se queste app hanno implementato l'elaborazione di ridimensionamento della finestra per chiamare ResizeBuffers, non devono chiamare in modo esplicito ResizeBuffers dopo aver chiamato ResizeTarget perché l'elaborazione del ridimensionamento della finestra otterrà ciò che richiede l'app.

Requisiti

Requisito Valore
Piattaforma di destinazione Windows
Intestazione dxgi.h
Libreria DXGI.lib

Vedi anche

IDXGISwapChain