Microsoft DirectX 8.0 (C++)

IDirectPlay8Peer::ReturnBuffer

DPN_MSGID_RECEIVE システム メッセージの pReceiveData メンバによってアプリケーションに提供されるメッセージ バッファを取得する。ユーザーのメッセージ ハンドラが RECEIVE コールバックに DPNSUCCESS_PENDING を返した場合、バッファの所有権はアプリケーションに移行したと見なされ、この呼び出しにより所有権が Microsoft® DirectPlay® に戻るまで所有権の解放や変更は行われない。

HRESULT ReturnBuffer(
const DPNHANDLE hBufferHandle,
const DWORD dwFlags
);

パラメータ

hBufferHandle
メッセージ用のバッファ ハンドルを指定する DPNHANDLE 型の変数。これは、DPN_MSGID_RECEIVE システム メッセージの hBufferHandle メンバで取得する。
dwFlags
予約済み。0 に設定しておく。

戻り値

成功した場合は S_OK を返し、失敗した場合は次のいずれかのエラー値を返す。

DPNERR_INVALIDHANDLE
DPNERR_INVALIDPARAM

動作環境

  Windows NT/2000 : Windows 2000 以降に対する再配布可能ファイルとして提供。
  Windows 95/98 : Windows 95 以降に対する再配布可能ファイルとして提供。
  ヘッダー : Dplay8.h で宣言。