Método IDXGISurface::Map (dxgi.h)

Obtenha um ponteiro para os dados contidos na superfície e negue o acesso de GPU à superfície.

Sintaxe

HRESULT Map(
  [out] DXGI_MAPPED_RECT *pLockedRect,
        UINT             MapFlags
);

Parâmetros

[out] pLockedRect

Tipo: DXGI_MAPPED_RECT*

Um ponteiro para os dados de superfície (consulte DXGI_MAPPED_RECT).

MapFlags

Tipo: UINT

Sinalizadores de leitura e gravação da CPU. Esses sinalizadores podem ser combinados com um OR lógico.

  • DXGI_MAP_READ – Permitir acesso de leitura da CPU.
  • DXGI_MAP_WRITE – Permitir acesso de gravação da CPU.
  • DXGI_MAP_DISCARD - Descarte o conteúdo anterior de um recurso quando ele for mapeado.

Valor retornado

Tipo: HRESULT

Retorna S_OK se tiver êxito; caso contrário, retorna um dos códigos de erro descritos no tópico DXGI_ERROR .

Comentários

Use IDXGISurface::Map para acessar uma superfície da CPU. Para liberar uma superfície mapeada (e permitir o acesso à GPU), chame IDXGISurface::Unmap.

Requisitos

   
Plataforma de Destino Windows
Cabeçalho dxgi.h
Biblioteca DXGI.lib

Confira também

IDXGISurface