Метод IGraphBuilder::SetLogFile (strmif.h)
[Функция, связанная с этой страницей DirectShow, является устаревшей функцией. Он был заменен MediaPlayer, IMFMediaEngine, и аудио/ видео захвата в Media Foundation. Эти функции оптимизированы для Windows 10 и Windows 11. Корпорация Майкрософт настоятельно рекомендует, чтобы новый код использовал MediaPlayer, IMFMediaEngine и аудио- и видеозахват в Media Foundation вместо DirectShow, когда это возможно. Корпорация Майкрософт предлагает переписать существующий код, использующий устаревшие API, чтобы по возможности использовать новые API.]
Метод SetLogFile задает файл для ведения журнала действий, выполняемых при попытке выполнения операции.
Синтаксис
HRESULT SetLogFile(
DWORD_PTR hFile
);
Параметры
hFile
Дескриптор файла журнала.
Возвращаемое значение
Возвращает S_OK.
Комментарии
Этот метод предназначен для использования в отладке; он помогает определить причину сбоя при автоматическом построении графа фильтров.
Параметр hFile должен быть открытым дескриптором файла. Приложение отвечает за открытие файла и его закрытие после завершения ведения журнала. Перед закрытием дескриптора файла вызовите SetLogFile с дескриптором файла NULL . Это гарантирует, что компонент не будет пытаться использовать дескриптор файла после его закрытия.
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | strmif.h (включая Dshow.h) |
| Библиотека | Strmiids.lib |