IPipeByte::P ull メソッド (objidl.h)

パイプ ソースからバイト型のデータを取得します。

構文

HRESULT Pull(
  [out] BYTE  *buf,
  [in]  ULONG cRequest,
  [out] ULONG *pcReturned
);

パラメーター

[out] buf

データを受信するメモリ バッファーへのポインター。 バッファーは、 cRequest で指定されたバイト数以上を保持できる必要があります。

[in] cRequest

要求されたバイト数。

[out] pcReturned

返される実際のバイト数。

戻り値

このメソッドは、データが正常に取得されたことを示すS_OKを返します。

注釈

Pull メソッドが呼び出されると、パイプのプロバイダーからデータが要求されます。 呼び出し元は、 cRequest パラメーターで指定されたバイト数以上を保持するバッファーを提供する必要があります。 プロキシは、指定されたバッファーにデータのマーシャリングを解除し、 pcReturned で実際に提供されるバイト数を設定します。 pcReturned パラメーターは cRequest 以下にすることができますが、それ以上になることはありません。 pcReturned が 0 の場合は、それ以上データがないことを示します。

要件

こちらもご覧ください

IPipeByte