Share via

Metode IDirectDrawSurface7::GetPrivateData (ddraw.h)

  • Artikel

Menyalin data privat yang terkait dengan permukaan ini ke buffer yang disediakan.

Sintaks

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

Parameter

[in] unnamedParam1

Referensi ke (C++) atau alamat (C) pengidentifikasi unik global yang mengidentifikasi data privat yang akan diambil.

[out] unnamedParam2

Penunjuk ke buffer yang dialokasikan sebelumnya yang menerima data privat yang diminta jika panggilan berhasil. Aplikasi yang memanggil metode ini harus mengalokasikan dan merilis buffer ini.

[in, out] unnamedParam3

Penunjuk ke variabel yang berisi nilai ukuran buffer di lpBuffer, dalam byte. Jika nilai ini kurang dari ukuran aktual data privat (seperti 0), GetPrivateData mengatur variabel ke ukuran buffer yang diperlukan, lalu mengembalikan DDERR_MOREDATA.

Nilai kembali

Jika metode berhasil, nilai yang dikembalikan adalah DD_OK.

Jika gagal, metode dapat mengembalikan salah satu nilai kesalahan berikut:

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

Persyaratan

Persyaratan Nilai
Target Platform Windows
Header ddraw.h
Pustaka Ddraw.lib
DLL Ddraw.dll

Lihat juga

IDirectDrawSurface7