Metodo IDXGIResource1::CreateSubresourceSurface (dxgi1_2.h)

Articolo
02/26/2024

Crea un oggetto surface subresource.

Sintassi

HRESULT CreateSubresourceSurface(
        UINT          index,
  [out] IDXGISurface2 **ppSurface
);

Parametri

index

Indice dell'oggetto surface subresource da enumerare.

[out] ppSurface

Indirizzo di un puntatore a un'interfaccia IDXGISurface2 che rappresenta l'oggetto surface di sottoresource creato nella posizione specificata dal parametro index .

Valore restituito

Restituisce S_OK se ha esito positivo; in caso contrario, restituisce uno dei valori seguenti:

DXGI_ERROR_INVALID_CALL se l'indice non è compreso nell'intervallo o se la sottoresource non è una superficie valida.
E_OUTOFMEMORY se è disponibile memoria insufficiente per creare l'oggetto superficie di subresource.

Una sottoresource è una superficie valida se la risorsa originale sarebbe stata una superficie valida con dimensioni della matrice pari a 1.

Commenti

Gli oggetti superficie subresource implementano l'interfaccia IDXGISurface2, che eredita da IDXGISurface1 e indirettamente IDXGISurface. Pertanto, i metodi GDI-interoperabili di IDXGISurface1 funzionano se l'oggetto dell'interfaccia della risorsa originale è stato creato con il flag di interoperabilità GDI (D3D11_RESOURCE_MISC_GDI_COMPATIBLE).

CreateSubresourceSurface crea una superficie di subresource basata sull'interfaccia della risorsa in cui viene chiamato CreateSubresourceSurface . Ad esempio, se l'oggetto dell'interfaccia della risorsa originale è una trama 2D, la superficie di subresource creata è anche una trama 2D.

È possibile usare CreateSubresourceSurface per creare parti di una risorsa stereo in modo da poter usare Direct2D nella parte sinistra o destra della risorsa stereo.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 8 e Aggiornamento della piattaforma per Windows 7 [app desktop \| App UWP]
Server minimo supportato	Windows Server 2012 e Aggiornamento della piattaforma per Windows Server 2008 R2 [app desktop \| App UWP]
Piattaforma di destinazione	Windows
Intestazione	dxgi1_2.h
Libreria	Dxgi.lib

Vedi anche

IDXGIResource1

Condividi tramite