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

Статья
03/05/2024

Копирует личные данные, связанные с этой поверхностью, в предоставленный буфер.

Синтаксис

HRESULT GetPrivateData(
  [in]      REFGUID unnamedParam1,
  [out]     LPVOID  unnamedParam2,
  [in, out] LPDWORD unnamedParam3
);

Параметры

[in] unnamedParam1

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

[out] unnamedParam2

Указатель на ранее выделенный буфер, который получает запрошенные частные данные в случае успешного вызова. Приложение, которое вызывает этот метод, должно выделить и освободить этот буфер.

[in, out] unnamedParam3

Указатель на переменную, содержащую значение размера буфера в lpBuffer в байтах. Если это значение меньше фактического размера частных данных (например, 0), GetPrivateData устанавливает для переменной требуемый размер буфера, а затем возвращает DDERR_MOREDATA.

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

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

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

DDERR_EXPIRED
DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_MOREDATA
DDERR_NOTFOUND
DDERR_OUTOFMEMORY

Требования

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

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

IDirectDrawSurface7

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