Metodo IDirect3DDevice9::CreateRenderTarget (d3d9helper.h)

Crea una superficie di destinazione di rendering.

Sintassi

HRESULT CreateRenderTarget(
  [in]          UINT                Width,
  [in]          UINT                Height,
  [in]          D3DFORMAT           Format,
  [in]          D3DMULTISAMPLE_TYPE MultiSample,
  [in]          DWORD               MultisampleQuality,
  [in]          BOOL                Lockable,
  [out, retval] IDirect3DSurface9   **ppSurface,
  [in]          HANDLE              *pSharedHandle
);

Parametri

[in] Width

Tipo: UINT

Larghezza della superficie di destinazione di rendering, in pixel.

[in] Height

Tipo: UINT

Altezza della superficie di destinazione di rendering, in pixel.

[in] Format

Tipo: D3DFORMAT

Membro del tipo enumerato D3DFORMAT , che descrive il formato della destinazione di rendering.

[in] MultiSample

Tipo: D3DMULTISAMPLE_TYPE

Membro del tipo enumerato D3DMULTISAMPLE_TYPE , che descrive il tipo di buffer multicampionamento. Questo parametro specifica il tipo di antialiasing per questa destinazione di rendering. Quando questa superficie viene passata a IDirect3DDevice9::SetRenderTarget, il tipo multisample deve essere uguale a quello dello stencil di profondità impostato da IDirect3DDevice9::SetDepthStencilSurface.

[in] MultisampleQuality

Tipo: DWORD

Livello di qualità. L'intervallo valido è compreso tra zero e uno inferiore al livello restituito da pQualityLevels utilizzato da IDirect3D9::CheckDeviceMultiSampleType. Il passaggio di un valore più grande restituisce l'errore, D3DERR_INVALIDCALL. I valori MultisampleQuality di destinazioni di rendering abbinate, superfici stencil di profondità e il tipo multisample devono corrispondere a tutti.

[in] Lockable

Tipo: BOOL

Le destinazioni di rendering non sono bloccabili a meno che l'applicazione non specifichi TRUE per Lockable.

Si noti che le destinazioni di rendering bloccabili riducono le prestazioni in alcuni hardware grafici. Le prestazioni di readback (lo spostamento dei dati dalla memoria video alla memoria di sistema) dipendono dal tipo di hardware usato (AGP e PCI Express) e in genere è molto inferiore alle prestazioni di caricamento (lo spostamento dei dati dal sistema alla memoria video). Se è necessario accedere in lettura alle destinazioni di rendering, usare GetRenderTargetData anziché destinazioni di rendering bloccabili.

[out, retval] ppSurface

Tipo: IDirect3DSurface9**

Indirizzo di un puntatore a un'interfaccia IDirect3DSurface9 .

[in] pSharedHandle

Tipo: HANDLE*

Riservato. Impostare questo parametro su NULL. Questo parametro può essere usato in Direct3D 9 per Windows Vista per condividere le risorse.

Valore restituito

Tipo: HRESULT

Se il metodo ha esito positivo, il valore restituito è D3D_OK. Se il metodo ha esito negativo, il valore restituito può essere uno dei seguenti: D3DERR_NOTAVAILABLE, D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY.

Commenti

Le superfici di destinazione di rendering vengono posizionate nella classe di memoria D3DPOOL_DEFAULT.

La creazione di destinazioni di rendering multicampionato bloccate non è supportata.

Requisiti

Vedi anche

IDirect3DDevice9