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 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 |