IDirectDrawSurface7::GetPrivateData 方法 (ddraw.h)
將與此表面相關聯的私人數據複製到提供的緩衝區。
語法
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 |
標頭 | ddraw.h |
程式庫 | Ddraw.lib |
Dll | Ddraw.dll |