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