Freigeben über


IDXGISurface1::GetDC-Methode (dxgi.h)

Gibt einen Gerätekontext (Device Context, DC) zurück, mit dem Sie mithilfe der Windows-Grafikgeräteschnittstelle (GDI) auf einer DXGI-Oberfläche (Microsoft DirectX Graphics Infrastructure) rendern können.

Syntax

HRESULT GetDC(
        BOOL Discard,
  [out] HDC  *phdc
);

Parameter

Discard

Typ: BOOL

Ein boolescher Wert, der angibt, ob Direct3D-Inhalte im GDI-DC beibehalten werden sollen. TRUE weist die Runtime an, Direct3D-Inhalte nicht im GDI-DC beizubehalten. Das heißt, die Runtime verwirft den Direct3D-Inhalt. FALSE garantiert, dass Direct3D-Inhalte im GDI DC verfügbar sind.

[out] phdc

Typ: HDC*

Ein Zeiger auf ein HDC-Handle , das den aktuellen Gerätekontext für das GDI-Rendering darstellt.

Rückgabewert

Typ: HRESULT

Gibt bei erfolgreicher Ausführung S_OK zurück. andernfalls ein Fehlercode.

Hinweise

Diese Methode wird von DXGI 1.0, das in Windows Vista und Windows Server 2008 ausgeliefert wurde, nicht unterstützt. DxGI 1.1-Unterstützung ist erforderlich, die unter Windows 7, Windows Server 2008 R2 und als Update auf Windows Vista mit Service Pack 2 (SP2) (KB 971644) und Windows Server 2008 (KB 971512) verfügbar ist.

Nachdem Sie die GetDC-Methode zum Abrufen eines DC verwendet haben, können Sie mithilfe von GDI auf der DXGI-Oberfläche rendern.
Die GetDC-Methode liest die Oberfläche für das GDI-Rendering und ermöglicht den Interbetrieb zwischen DXGI- und GDI-Technologien.

Beachten Sie folgendes, wenn Sie diese Methode verwenden:

Sie können GetDC auch auf dem Hintergrundpuffer bei Index 0 einer Swapchain aufrufen, indem Sie eine IDXGISurface1 aus der Swapchain abrufen. Der folgende Code veranschaulicht den Prozess.

IDXGISwapChain* g_pSwapChain = NULL;
IDXGISurface1* g_pSurface1 = NULL;
...
//Setup the device and the swapchain
g_pSwapChain->GetBuffer(0, __uuidof(IDXGISurface1), (void**) &g_pSurface1);
g_pSurface1->GetDC( FALSE, &g_hDC );
...      
//Draw on the DC using GDI
...
//When finish drawing release the DC
g_pSurface1->ReleaseDC( NULL );
      

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Zielplattform Windows
Kopfzeile dxgi.h
Bibliothek DXGI.lib

Weitere Informationen

DXGI-Schnittstellen

IDXGISurface1