IDXGISurface::Map-Methode (dxgi.h)

  • Artikel

Rufen Sie einen Zeiger auf die in der Oberfläche enthaltenen Daten ab, und verweigern Sie gpu-Zugriff auf die Oberfläche.

Syntax

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

Parameter

[out] pLockedRect

Typ: DXGI_MAPPED_RECT*

Ein Zeiger auf die Oberflächendaten (siehe DXGI_MAPPED_RECT).

MapFlags

Typ: UINT

CPU-Lese-/Schreibflags. Diese Flags können mit einem logischen OR kombiniert werden.

  • DXGI_MAP_READ: Cpu-Lesezugriff zulassen.
  • DXGI_MAP_WRITE: Cpu-Schreibzugriff zulassen.
  • DXGI_MAP_DISCARD: Verwerfen Sie den vorherigen Inhalt einer Ressource, wenn sie zugeordnet wird.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK zurück. Gibt andernfalls einen der Fehlercodes zurück, die im Thema DXGI_ERROR beschrieben werden.

Hinweise

Verwenden Sie IDXGISurface::Map , um über die CPU auf eine Oberfläche zuzugreifen. Rufen Sie IDXGISurface::Unmap auf, um eine zugeordnete Oberfläche freizugeben (und GPU-Zugriff zuzulassen).

Anforderungen

   
Zielplattform Windows
Kopfzeile dxgi.h
Bibliothek DXGI.lib

Weitere Informationen

IDXGISurface