Platform SDK: DirectX

IDirectDrawSurface7::FreePrivateData

IDirectDrawSurface7::FreePrivateData メソッドは、このサーフェスに関連付けられた指定するプライベート データを解放する。

HRESULT FreePrivateData( 
  REFGUID guidTag 
); 

パラメータ

guidTag
解放するプライベート データを識別するグローバル ユニーク識別子の (C++) または (C) のアドレスへの参照。

戻り値

成功すれば、DD_OK を返す。

失敗すれば、以下のエラー値のいずれかを返す。

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS
DDERR_NOTFOUND

注意

DirectDraw は、サーフェスが解放されると自動的にこのメソッドを呼び出す。

プライベート データが DDSPD_IUNKNOWNPOINTER フラグを使用して設定されている場合、このメソッドは関連付けられたインターフェイスの IUnknown::Release メソッドを呼び出す。

動作環境

  Windows NT/2000 :Windows 2000 が必要。
  Windows 95/98 : Windows 98 が必要。
  ヘッダー : ddraw.h で宣言。

参照

IDirectDrawSurface7::GetPrivateDataIDirectDrawSurface7::SetPrivateData