Метод IMFByteStream::GetCapabilities (mfobjects.h)

  • Статья

Извлекает характеристики потока байтов.

Синтаксис

HRESULT GetCapabilities(
  [out] DWORD *pdwCapabilities
);

Параметры

[out] pdwCapabilities

Получает побитовое ИЛИ , равное нулю или нескольким флагам. Определены следующие флаги.

Значение Значение
MFBYTESTREAM_IS_READABLE
0x00000001
 Поток байтов можно считать.
MFBYTESTREAM_IS_WRITABLE
0x00000002
 Поток байтов можно записать в .
MFBYTESTREAM_IS_SEEKABLE
0x00000004
 Можно искать поток байтов.
MFBYTESTREAM_IS_REMOTE
0x00000008
 Поток байтов получен из удаленного источника, например сети.
MFBYTESTREAM_IS_DIRECTORY
0x00000080
 Поток байтов представляет каталог файлов.
MFBYTESTREAM_HAS_SLOW_SEEK
0x00000100
 Поиск в этом потоке может быть медленным. Например, поток байтов может скачивать из сети.
MFBYTESTREAM_IS_PARTIALLY_DOWNLOADED
0x00000200
 В настоящее время поток байтов загружает данные в локальный кэш. Операции чтения в потоке байтов могут занять больше времени, пока данные не будут полностью загружены.

Этот флаг удаляется после загрузки всех данных.

Если также установлен флаг MFBYTESTREAM_HAS_SLOW_SEEK , это означает, что поток байтов должен последовательно скачать весь файл. В противном случае поток байтов может отвечать на запросы поиска, перезапуская скачивание из новой точки потока.
MFBYTESTREAM_SHARE_WRITE
0x00000400
 Другой поток или процесс может открыть этот поток байтов для записи. Если этот флаг присутствует, длина потока байтов может измениться во время чтения.

Этот флаг может повлиять на поведение обработчиков байтового потока. Дополнительные сведения см. в разделе MF_BYTESTREAMHANDLER_ACCEPTS_SHARE_WRITE.

Примечание Требуется Windows 7 или более поздней версии.
 
MFBYTESTREAM_DOES_NOT_USE_NETWORK
0x00000800
 Поток байтов в настоящее время не использует сеть для получения содержимого. Сетевое оборудование может перейти в состояние энергосбережения, если задан этот бит.
Примечание Требуется Windows 8 или более поздней версии.
 

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

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

Комментарии

Этот интерфейс доступен на следующих платформах, если установлены распространяемые компоненты пакета SDK формата 11 для Windows Media:

  • Windows XP с пакетом обновления 2 (SP2) и более поздних версий.
  • Windows XP Media Center Edition 2005 с установленным KB900325 (Windows XP Media Center Edition 2005) и KB925766 (накопительный пакет обновления для Windows XP Media Center Edition за октябрь 2006 г.).

Требования

Требование Значение
Минимальная версия клиента Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header mfobjects.h (включая Mfidl.h)
Библиотека Mfuuid.lib

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

IMFByteStream