IKsDataTypeHandler::KsPrepareIoOperation メソッド (ksproxy.h)

  • [アーティクル]

KsPrepareIoOperation メソッドは、拡張ヘッダーを初期化し、I/O 操作用のメディア サンプルを準備します。

構文

HRESULT KsPrepareIoOperation(
  [in, out] IMediaSample  *Sample,
  [in, out] PVOID         StreamHeader,
  [in]      KSIOOPERATION IoOperation
);

パラメーター

[in, out] Sample

関連付けられているメディア サンプルの IMediaSample インターフェイスへのポインター。

[in, out] StreamHeader

拡張ヘッダー情報を含むバッファーへのポインター。

[in] IoOperation

I/O 操作の種類を示す 値。 この値には、KSIOOPERATION 列挙型の次のいずれかの値を指定できます。

値 説明
KsIoOperation_Write ストリームにデータを書き込みます。
KsIoOperation_Read ストリームからデータを読み取ります。

戻り値

成功した場合は NOERROR を返します。それ以外の場合は、エラー コードを返します。 ストリームのメジャー型がKSDATAFORMAT_TYPE_AUDIOの場合、 KsPrepareIoOperation 呼び出しは適用できないため、 KsPrepareIoOperation は自動的に NOERROR を返します。

注釈

クライアントは、データ型ハンドラーが IKsDataTypeHandler::KsQueryExtendedSize メソッドの呼び出しに拡張ヘッダー情報が存在することをクライアントに示した場合にのみ KsPrepareIoOperation を呼び出します。

IMediaSample の詳細については、Microsoft Windows SDKドキュメントを参照してください。

要件

要件 値
対象プラットフォーム デスクトップ
Header ksproxy.h (Ksproxy.h を含む)

こちらもご覧ください

IKsDataTypeHandler::KsQueryExtendedSize