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

Статья
08/24/2023

Начинает асинхронный запрос для создания потока байтов из файла.

Синтаксис

HRESULT MFBeginCreateFile(
  [in]  MF_FILE_ACCESSMODE AccessMode,
  [in]  MF_FILE_OPENMODE   OpenMode,
  [in]  MF_FILE_FLAGS      fFlags,
  [in]  LPCWSTR            pwszFilePath,
  [in]  IMFAsyncCallback   *pCallback,
  [in]  IUnknown           *pState,
  [out] IUnknown           **ppCancelCookie
);

Параметры

[in] AccessMode

Запрошенный режим доступа, указанный как член перечисления MF_FILE_ACCESSMODE .

[in] OpenMode

Поведение функции, если файл уже существует или не существует, указывается как член перечисления MF_FILE_OPENMODE .

[in] fFlags

Побитовое ИЛИ значений из перечисления MF_FILE_FLAGS .

[in] pwszFilePath

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

[in] pCallback

Указатель на интерфейс IMFAsyncCallback объекта обратного вызова. Вызывающий объект должен реализовать этот интерфейс

[in] pState

Указатель на интерфейс IUnknown объекта состояния, определенного вызывающим объектом. Этот параметр может принимать значение NULL. Этот объект можно использовать для хранения сведений о состоянии. Объект возвращается вызывающей объекту при вызове обратного вызова.

[out] ppCancelCookie

Получает указатель IUnknown или значение NULL. Если значение не равно NULL, можно отменить асинхронную операцию, передав этот указатель на функцию MFCancelCreateFile . Вызывающий объект должен освободить интерфейс . Этот параметр является необязательным и может иметь значение NULL.

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

Функция возвращает HRESULT. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.

Код возврата	Описание
S_OK	Функция выполнена успешно.

После завершения запроса вызывается метод IMFAsyncCallback::Invoke объекта обратного вызова. Затем объект обратного вызова должен вызвать функцию MFEndCreateFile , чтобы получить указатель на поток байтов.

Требования


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

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

Функции Media Foundation