ID2D1GdiInteropRenderTarget::GetDC-Methode (d2d1.h)

Ruft den Gerätekontext ab, der diesem Renderziel zugeordnet ist.

Syntax

HRESULT GetDC(
        D2D1_DC_INITIALIZE_MODE mode,
  [out] HDC                     *hdc
);

Parameter

mode

Typ: D2D1_DC_INITIALIZE_MODE

Ein -Wert, der angibt, ob der Gerätekontext gelöscht werden soll.

[out] hdc

Typ: HDC*

Wenn diese Methode zurückgibt, enthält den Gerätekontext, der diesem Renderziel zugeordnet ist. Sie müssen Speicher für diesen Parameter zuordnen.

Rückgabewert

Typ: HRESULT

Wenn diese Methode erfolgreich ist, wird S_OK zurückgegeben. Andernfalls wird ein HRESULT-Fehlercode zurückgegeben.

Hinweise

Wenn Sie diese Methode aufrufen, wird das Renderziel geleert.

Dieser Befehl kann nur nach BeginDraw und vor EndDraw aufgerufen werden.

Hinweis In Windows 7 und früher sollten Sie GetDC nicht zwischen PushAxisAlignedClip/PopAxisAlignedClip-Befehlen oder zwischen PushLayerPopLayer/ aufrufen. Diese Einschränkung gilt jedoch nicht für Windows 8 und höher.
 

ReleaseDC muss für jeden Aufruf von GetDC einmal aufgerufen werden.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7, Windows Vista mit SP2 und Plattformupdate für Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2, Windows Server 2008 mit SP2 und Plattformupdate für Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile d2d1.h
Bibliothek D2d1.lib
DLL D2d1.dll

Weitere Informationen

ID2D1GdiInteropRenderTarget