IDXGISurface2::GetResource-Methode (dxgi1_2.h)

Ruft die übergeordnete Ressource und den Unterressourcenindex ab, die eine Unterressourcenoberfläche unterstützen.

Syntax

HRESULT GetResource(
  [in]  REFIID riid,
  [out] void   **ppParentResource,
  [out] UINT   *pSubresourceIndex
);

Parameter

[in] riid

Der globally unique Identifier (GUID) des angeforderten Schnittstellentyps.

[out] ppParentResource

Ein Zeiger auf einen Puffer, der einen Zeiger auf das übergeordnete Ressourcenobjekt für die Unterressourcenoberfläche empfängt.

[out] pSubresourceIndex

Ein Zeiger auf eine Variable, die den Index der Unterressourcenoberfläche empfängt.

Rückgabewert

Gibt bei erfolgreicher Ausführung S_OK zurück. Gibt andernfalls einen der folgenden Werte zurück:

  • E_NOINTERFACE, wenn das Objekt nicht die GUID implementiert, die der riid-Parameter angibt.
  • Möglicherweise andere Fehlercodes, die im Thema DXGI_ERROR beschrieben werden.

Hinweise

Für Unterressourcenoberflächenobjekte, die von der IDXGIResource1::CreateSubresourceSurface-Methode erstellt werden, gibt GetResource einfach die Werte zurück, die zum Erstellen der Unterressourcenoberfläche verwendet wurden.

Aktuelle Objekte, die IDXGISurface implementieren, sind entweder Ressourcen oder Ansichten. GetResource für diese Objekte gibt "this" oder die Ressource zurück, die die Ansicht unterstützt. In dieser Situation ist der Unterressourcenindex 0.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 8 und Plattformupdate für Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2012 und Plattformupdate für Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile dxgi1_2.h
Bibliothek Dxgi.lib

Weitere Informationen

IDXGISurface2