Нет, это не ошибка в движке Хабры, и не повтор статьи, опубликованной на прошлой неделе и посвященной технологии WiDi. В этот раз мы поговорим о том, как разработчики могут использовать WiDi в своих приложениях. А Вы знали, что для работы с WiDi существует WiDi Extension SDK? Нет? Тогда эта статья для Вас.Кому из разработчиков это может пригодиться? По идее это может ограничиваться только фантазией разработчика. Идеи лежащие на поверхности — это программы для воспроизведения видео или аудио с визуализацией, программы для просмотра фото. Умная программа может определить наличие WiDi в системе и предложить пользователю отображать воспроизводимый контент на экране телевизора. Возможно, что на данный момент эта тема не слишком актуальна — WiDi адаптеров в настоящий момент не так уж и много.
Но в ближайшем будущем, после того как WiDi адаптеры начнут устанавливать сразу в телевизоры, например компания LG уже продемонстрировала первый телевизор на CES 2012 и собирается начать их выпуск в этом году, данная тема заинтересует многих разработчиков.
Для разработчиков, желающих встроить функционал для работы с WiDi в свои приложения, компания Intel выпустила Intel WiDi Extensions SDK. Данный SDK позволяет:
- Определять наличие и работоспособность WiDi
- Поиск и определение адаптеров готовых к подключению
- Подключение к адаптеру
- Изменение параметров экрана, режима отображения (клонировать экран, расширить рабочий стол на второй экран)
В SDK Вы найдете документацию, файлы, необходимые для включения в проект и примеры на C++, C#.
Кстати, для разработки приложения, работающего с WiDi, не обязательно иметь железо, поддерживающее данную технологию. Такое железо понадобится только для тестирования.
Начнем встраивать функционал для работы с WiDi в свою программу.
Для начала необходимо перейти на сайт и скачать Intel WiDi Extensions SDK. Внутри архива лежит дистрибутив, содержащий сам SDK. Сохраняем, распаковываем, устанавливаем.
Создаем наше тестовое приложение, подключаем к проекту заголовочный файл
#include <IntelWiDiExtensions_i.h>
Первое, что необходимо сделать, это создать и инициализировать IWiDiExtensions
HRESULT hr;
hr = CoCreateInstance(CLSID_WiDiExtensions, NULL, CLSCTX_INPROC_SERVER, __uuidof(IWiDiExtensions), (LPVOID*)&m_pWiDi);
if(hr == S_OK)
{
hr = m_pWiDi->Initialize((DWORD)m_hWnd);
}
Все функции WiDi API являются асинхронными. Для уведомления о результате выполненной операции используются оконные сообщения, посылаемые окну, хэндл которого был передан при вызове функции Initialize.
HRESULT Initialize(
HWND windowHandle
);
Для того, чтобы получить уведомление об успешном окончании инициализации, окно приложения должно уметь обрабатывать сообщение WM_WIDI_INITIALIZED.
Для получения уведомления об ошибке, возникшей в процессе инициализации, используется сообщение WM_WIDI_INITIALIZATION_FAILED. Параметр wParam обработчика сообщения WM_WIDI_INITIALIZATION_FAILED будет содержать соответствующий код ошибки:
RC_WIDI_APP_NOT_FOUND // Не установлено приложение для работы с WiDi
RC_WIDI_FAILED_TO_START // Не удалось запустить приложение для работы с WiDi
RC_INTERNAL_ERROR // Произошла внутренняя ошибка
RC_WIDI_APPLICATION_ERROR // Неизвестная ошибка
После успешной инициализации можно приступать к поиску доступных WiDi адаптеров. Делается это с помощью функции StartScanForAdapters
HRESULT StartScanForAdapters();
Для уведомления о найденном адаптере используется сообщение WM_WIDI_ADAPTER_DISCOVERED. Параметр lParam будет указатель на идентификатор адаптера. Данный идентификатор необходим для подключения к выбранному адаптеру.
После окончания поиска окно получит сообщение WM_WIDI_SCAN_COMPLETE. Параметр wParam будет содержать код, анализ которого поможет определить, по какой причине было завершено сканирование:
RC_SUCCESS // Поиск успешно завершен
RC_UNABLE_TO_START_SCAN // Поиск не удалось запустить
RC_INTERNAL_ERROR // Произошла внутренняя ошибка
RC_WIDI_APPLICATION_ERROR // Произошла внутренняя ошибка приложения для работы с WiDi
RC_CONNECT_CANCELLED_SCAN // Поиск был прерван
Если было обнаружено одно и более устройство, можно приступать к подключению. Подключение осуществляется вызовом функции StartConnectionToAdapter.
HRESULT StartConnectionToAdapter(
BSTR AdapterUniqueID,
int SourceScreenResolution,
int TargetScreenResolution,
ScreenMode Mode
);
После успешного подключения окно получит сообщение WM_WIDI_CONNECTED. В случае возникновения проблем — WM_WIDI_DISCONNECT_FAILED, параметр wParam будет содержать код:
RC_CONNECTION_DROPPED // Подключение не было установлено
RC_USER_DISCONNECT // Подключение было прервано пользователем
В параметр lParam будет передан идентификатор адаптера.
На этом пока все. Для получения более подробной информации о возможностях WiDi Extensions SDK Вы можете изучить документацию, которая поставляется в комплекте с SDK. Будут вопросы — задавайте здесь, в комментариях, либо на форуме Intel Software Network.
