Поделиться через


Функция MFRegisterLocalByteStreamHandler (mfapi.h)

Регистрирует обработчик потока байтов в процессе вызывающего.

Синтаксис

HRESULT MFRegisterLocalByteStreamHandler(
  [in] PCWSTR      szFileExtension,
  [in] PCWSTR      szMimeType,
  [in] IMFActivate *pActivate
);

Параметры

[in] szFileExtension

Строка, содержащая расширение имени файла для этого обработчика.

[in] szMimeType

Строка, содержащая тип MIME для данного обработчика.

[in] pActivate

Указатель на интерфейс IMFActivate объекта активации. Вызывающий объект реализует этот интерфейс. Метод IMFActivate::ActivateObject объекта активации должен создать обработчик потока байтов. Обработчик потока байтов предоставляет интерфейс IMFByteStreamHandler .

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

Если эта функция завершается успешно, она возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Обработчики потока байтов используются в Microsoft Media Foundation во время процесса разрешения источника, который создает источник мультимедиа на основе URL-адреса. Дополнительные сведения см. в разделе Обработчики схем и обработчики Byte-Stream.

В рамках процесса локальные обработчики байтового потока имеют приоритет над обработчиками байтового потока, зарегистрированными в реестре. Локальные обработчики потока байтов не видны другим процессам.

Используйте эту функцию, если вы хотите зарегистрировать настраиваемый обработчик потока байтов для приложения, но не хотите, чтобы обработчик был доступен для других приложений.

SzFileExtension или szMimeType может иметь значение NULL; по крайней мере один должен иметь значение, отличное от NULL.

Требования

Требование Значение
Минимальная версия клиента Windows 8 [только классические приложения]
Минимальная версия сервера Windows Server 2012 [только классические приложения]
Целевая платформа Windows
Header mfapi.h
Библиотека Mfplat.lib
DLL Mfplat.dll

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

Функции Media Foundation

Обработчики схем и обработчики Byte-Stream