Метод IDirectDrawSurface7::SetPrivateData (ddraw.h)

Статья
08/23/2023

Связывает данные с поверхностью, которая предназначена для использования приложением, а не DirectDraw. Данные передаются по значению, и несколько наборов данных могут быть связаны с одной поверхностью.

Синтаксис

HRESULT SetPrivateData(
  [in] REFGUID unnamedParam1,
  [in] LPVOID  unnamedParam2,
  [in] DWORD   unnamedParam3,
  [in] DWORD   unnamedParam4
);

Параметры

[in] unnamedParam1

Ссылка на (C++) или адрес (C) глобально уникальный идентификатор, определяющий устанавливаемые частные данные.

[in] unnamedParam2

Указатель на буфер, содержащий данные, связанные с поверхностью.

[in] unnamedParam3

Значение размера буфера в lpData в байтах.

[in] unnamedParam4

Значение, которое можно задать для одного из следующих флагов. Эти флаги описывают тип передаваемых данных или запрос на аннулирование данных при изменении поверхности.

(нет)

Если флаги не указаны, DirectDraw выделяет память для хранения данных в буфере и копирует данные в новый буфер. Буфер, выделенный DirectDraw, автоматически освобождается при необходимости.

DDSPD_IUNKNOWNPOINTER

Данные в lpData являются указателем на интерфейс IUnknown . DirectDraw автоматически вызывает метод IUnknown::AddRef этого интерфейса. Если эти данные больше не нужны, DirectDraw автоматически вызывает метод IUnknown::Release этого интерфейса.

DDSPD_VOLATILE

Буфер в lpData действителен только в том случае, если поверхность остается неизменной. Если содержимое поверхности изменяется, последующие вызовы метода IDirectDrawSurface7::GetPrivateData возвращают DDERR_EXPIRED.

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

Если метод выполнен успешно, возвращаемое значение будет DD_OK.

В случае сбоя метод может вернуть одно из следующих значений ошибки:

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_OUTOFMEMORY

Требования

Требование	Значение
Целевая платформа	Windows
Header	ddraw.h
Библиотека	Ddraw.lib
DLL	Ddraw.dll

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

IDirectDrawSurface7

Поделиться через