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

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 como o tamanho do buffer necessário e retornará DDERR_MOREDATA.

Valor de retorno

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

Observações

Se os dados retornados forem um ponteiro para um IUnknown ou uma de suas classes derivadas, que foi definida anteriormente por SetPrivateData com um DDSPD_IUNKNOWNPOINTER sinalizador, essa interface terá sua contagem de referência incrementada antes que os dados privados sejam retornados.

Requisitos

Consulte também

IDirectDrawSurface7