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 |
Library | Ddraw.lib |
[DLL] | Ddraw.dll |