Метод ID2D1GdiInteropRenderTarget::GetDC (d2d1.h)

  • Статья

Извлекает контекст устройства, связанный с этим целевым объектом отрисовки.

Синтаксис

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

Параметры

mode

Тип: D2D1_DC_INITIALIZE_MODE

Значение типа , указывающее, следует ли очищать контекст устройства.

[out] hdc

Тип: HDC*

При возврате этого метода содержит контекст устройства, связанный с этим целевым объектом отрисовки. Для этого параметра необходимо выделить хранилище.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Вызов этого метода очищает целевой объект отрисовки.

Эту команду можно вызывать только после BeginDraw и перед EndDraw.

Примечание В Windows 7 и более ранних версиях не следует вызывать GetDC между командами PushAxisAlignedClip/PopAxisAlignedClip или PushLayer/PopLayer. Однако это ограничение не применяется к Windows 8 и более поздним версиям.
 

ReleaseDC должен вызываться один раз для каждого вызова GetDC.

Требования

   
Минимальная версия клиента Windows 7, Windows Vista с пакетом обновления 2 (SP2) и Обновление платформы для Windows Vista [только классические приложения]
Минимальная версия сервера Windows Server 2008 R2, Windows Server 2008 с пакетом обновления 2 (SP2) и Обновление платформы для Windows Server 2008 [только классические приложения]
Целевая платформа Windows
Header d2d1.h
Библиотека D2d1.lib
DLL D2d1.dll

См. также раздел

ID2D1GdiInteropRenderTarget