Функция MFBeginCreateFile (mfapi.h)
Начинает асинхронный запрос для создания потока байтов из файла.
Синтаксис
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. Допустимые значения включают, но не ограничиваются, значения, приведенные в следующей таблице.
| Код возврата | Описание |
|---|---|
|
Функция выполнена успешно. |
Комментарии
После завершения запроса вызывается метод IMFAsyncCallback::Invoke объекта обратного вызова. Затем объект обратного вызова должен вызвать функцию MFEndCreateFile , чтобы получить указатель на поток байтов.
Требования
| Минимальная версия клиента | Windows Vista [только классические приложения] |
| Минимальная версия сервера | Windows Server 2008 [только классические приложения] |
| Целевая платформа | Windows |
| Header | mfapi.h |
| Библиотека | Mfplat.lib |
| DLL | Mfplat.dll |