Compartilhar via

Método IDirectDrawSurface7::GetPrivateData (ddraw.h)

  • Artigo

Copia os dados privados associados a essa superfície para um buffer fornecido.

Sintaxe

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

Parâmetros

[in] unnamedParam1

Referência a (C++) ou endereço de (C) o identificador global exclusivo que identifica os dados privados a serem recuperados.

[out] unnamedParam2

Um ponteiro para um buffer alocado anteriormente que recebe os dados privados solicitados se a chamada for bem-sucedida. O aplicativo que chama esse método deve alocar e liberar esse buffer.

[in, out] unnamedParam3

Um ponteiro para uma variável que contém o valor de tamanho do buffer em lpBuffer, em bytes. Se esse valor for menor que o tamanho real dos dados privados (como 0), GetPrivateData definirá a variável para o tamanho do buffer necessário e retornará DDERR_MOREDATA.

Retornar valor

Se o método for bem-sucedido, o valor retornado será DD_OK.

Se falhar, o método poderá retornar um dos seguintes valores de erro:

  • DDERR_EXPIRED
  • DDERR_INVALIDOBJECT
  • DDERR_INVALIDPARAMS
  • DDERR_MOREDATA
  • DDERR_NOTFOUND
  • DDERR_OUTOFMEMORY

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho ddraw.h
Biblioteca Ddraw.lib
DLL Ddraw.dll

Confira também

IDirectDrawSurface7