このサーフェスに関連付けられているプライベート データを指定されたバッファーにコピーします。
構文
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
注釈
返されるデータが IUnknown へのポインターである場合、またはその派生クラスの 1 つ (DDSPD_IUNKNOWNPOINTER フラグを使用して SetPrivateData によって以前に設定された) は、プライベート データが返される前に、そのインターフェイスの参照カウントがインクリメントされます。
要求事項
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | ウィンドウズ |
| ヘッダー | ddraw.h |
| 図書館 | Ddraw.lib |
| DLL | Ddraw.dll |
こちらも参照ください
IDirectDrawSurface7 の