Метод IKsDataTypeHandler::KsPrepareIoOperation (ksproxy.h)

Метод KsPrepareIoOperation инициализирует расширенный заголовок и подготавливает образец носителя для операции ввода-вывода.

Синтаксис

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

Параметры

[in, out] Sample

Указатель на интерфейс IMediaSample для связанного примера мультимедиа.

[in, out] StreamHeader

Указатель на буфер, содержащий расширенные сведения о заголовке.

[in] IoOperation

Значение, указывающее тип операции ввода-вывода. Это значение может быть одним из следующих значений из перечисленного типа KSIOOPERATION:

Значение	Описание
KsIoOperation_Write	Запись данных в поток.
KsIoOperation_Read	Чтение данных из потока.

Возвращаемое значение

В случае успешного выполнения возвращает значение NOERROR; в противном случае возвращает код ошибки. Если основной тип потока KSDATAFORMAT_TYPE_AUDIO, вызов KsPrepareIoOperation не применяется, поэтому KsPrepareIoOperation автоматически возвращает NOERROR.

Комментарии

Клиент вызывает KsPrepareIoOperation , только если обработчик типа данных указал клиенту наличие расширенных сведений о заголовке в вызове метода IKsDataTypeHandler::KsQueryExtendedSize .

Дополнительные сведения об IMediaSample см. в документации по Microsoft Windows SDK.

Требования

Требование	Значение
Целевая платформа	Персональный компьютер
Верхняя часть	ksproxy.h (включая Ksproxy.h)

См. также раздел

IKsDataTypeHandler::KsQueryExtendedSize