Функция 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 |