IDirectPlay8Server::ReturnBuffer メソッド

  • [アーティクル]

IDirectPlay8Server::ReturnBuffer メソッド

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

構文

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

パラメータ

  • hBufferHandle
    [in] メッセージ用のバッファ ハンドルを指定する DPNHANDLE 型の変数。これは、DPN_MSGID_RECEIVE システム メッセージの hBufferHandle メンバで取得する。
  • dwFlags
    [in] 予約済み。0 でなければならない。

戻り値

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

DPNERR_INVALIDHANDLE 指定されたハンドルは無効である。
DPNERR_INVALIDPARAM メソッドに渡された 1 つあるいは複数のパラメータが無効である。