次の方法で共有


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 のドキュメントを参照してください。

必要条件

要件 価値
ターゲット プラットフォーム デスクトップ
ヘッダー ksproxy.h (Ksproxy.h を含む)

関連項目

IKsDataTypeHandler::KsQueryExtendedSize