MciSendString

MCIERROR mciSendString( LPCTSTR lpszCommand, LPTSTR lpszReturnString, UINT cchReturn, HANDLE hwndCallback );

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

В случае успешного завершения работы функции возвращает нулевое значение, и значение ошибки в противном случае. Младшее слово возвращаемого двойного слова содержит значение ошибки. Если ошибка специфична для устройства, в старшем слове возвращаемого значения содержится идентификатор драйвера, и нулевое значение в противном случае.

Для получения текстуального описания значений ошибок, возвращаемых функцией mciSendString, следует передать это значение функции mciGetErrorString.

Аргументы

0. lpszCommand — указатель на заканчивающуюся нулём строку, определяющую командную строку MCI.

1. lpszReturnString — указатель на буфер, в который будет записана возвращаемая информация. Если возвращение информации не предполагается, этот аргумент может иметь нулевое значение.

2. cchReturn — размер буфера, на который указывает аргумент lpszReturnString, в байтах.

3. hwndCallback — дескриптор окна, которое будет получать извещения, если в командной строке установлен соответствующий флаг.

Примечание

Функция mciSendString посылает командную строку устройству MCI. Устройство, которому посылается команда, определяется в командной строке.

Описание данной функции содержится в файле заголовка mmsystem.h. При работе с данной функцией следует включить в проект библиотеку winmm.lib.

MciSetYieldProc

UINT mciSetYieldProc( MCIDEVICEID IDDevice, YIELDPROC yp, DWORD dwYieldData );

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

В случае успешного завершения работы возвращает значение TRUE и значение FALSE в противном случае.

Аргументы

0. IDDevice — идентификатор устройства, которому назначается новая функция обратного вызова.

1. yp — указатель на назначаемую функцию обратного вызова. Этот аргумент может иметь нулевое значение, если требуется отменить использование функций обратного вызова.

2. dwYieldData — данные передаваемые функции обратного вызова при её вызове для указанного устройства.

Примечание

Функция mciSetYieldProc передаёт драйверу устройства указатель на функцию обратного вызова, связанную с флагом ожидания (MCI_WAIT). Функция обратного вызова периодически вызывается в процессе ожидания устройством MCI поступления команды, указанной во флаге ожидания.

Эта функция перегружает используемую до этого функцию обратного вызова.

Описание данной функции содержится в файле заголовка mmsystem.h. При работе с данной функцией следует включить в проект библиотеку winmm.lib.

MciWndCreate

HWND MCIWndCreate( HWND hwndParent, HINSTANCE hInstance, DWORD dwStyle, LPSTR szFile );

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

В случае успешного завершения работы возвращает дескриптор окна MCI. В противном случае возвращает нулевое значение.

Аргументы

0. hwndParent — дескриптор родительского окна.

1. hInstance — дескриптор экземпляра модуля, связанного с окном MCIWnd.

2. dwStyle — флаги, определяющие стили окна. Кроме стилей, определённых в функции CreateWindowEx для окна MCIWnd могут быть определены следующие стили:

• MCIWNDF_NOAUTOSIZEWINDOW — окно MCIWnd не изменяет размера при изменении размеров изображения.

• MCIWNDF_NOAUTOSIZEMOVIE — не изменяет размера изображения при изменении размеров окна MCIWnd.

• MCIWNDF_NOERRORDLG — запрещает вывод пользователю сообщений об ошибках MCI.

• MCIWNDF_NOMENU — скрывает кнопку Меню с панели инструментов и запрещает пользователю использовать контекстные меню.

• MCIWNDF_NOOPEN — скрывает команды открытия и закрытия файлов в меню MCIWnd и запрещает пользователю выделять эти команды в контекстном меню.

• MCIWNDF_NOPLAYBAR — скрывает панель инструментов и запрещает доступ пользователя к ней.

• MCIWNDF_NOTIFYANSI — заставляет окно MCIWnd использовать строки ANSI вместо строк Unicode при оповещении родительского окна о смене режима устройства. Этот флаг используется совместно с флагом MCIWNDF_NOTIFYMODE исключительно в операционной система Windows NT.

• MCIWNDF_NOTIFYMODE — заставляет окно MCIWnd посылать родительскому окну сообщение MCIWNDM_NOTIFYMODE при изменении режима работы устройства. В аргументе lParam данного сообщения передаётся идентификатор нового режима, например, MCI_MODE_STOP.

• MCIWNDF_NOTIFYPOS — заставляет окно MCIWnd посылать родительскому окну сообщение MCIWNDM_NOTIFYPOS при перемещении текущей позиции записи или воспроизведения. В аргументе lParam данного сообщения передаётся новая текущая позиция.

• MCIWNDF_NOTIFYMEDIA — заставляет окно MCIWnd посылать родительскому окну сообщение MCIWNDM_NOTIFYMEDIA при использовании нового устройства или открытии и закрытии файла данных. В аргументе lParam данного сообщения передаётся указатель на новое имя файла.

• MCIWNDF_NOTIFYSIZE — заставляет окно MCIWnd извещать родительское окно об изменении своих размеров.

• MCIWNDF_NOTIFYERROR — заставляет окно MCIWnd извещать родительское окно о возникновении ошибки MCI.

• MCIWNDF_NOTIFYALL — заставляет окно MCIWnd посылать родительскому окну все сообщения формата MCIWNDM_.

• MCIWNDF_RECORD — добавляет в панель инструментов кнопку Запись и добавляет новую команду в меню, если устройство MCI способно производить запись информации.

• MCIWNDF_SHOWALL — используются все стили формата MCIWNDF_SHOW.

• MCIWNDF_SHOWMODE — отображает текущий режим устройства MCI в заголовке окна.

• MCIWNDF_SHOWNAME — отображает в заголовке окна имя устройства MCI или файла данных.

• MCIWNDF_SHOWPOS — отображает в заголовке окна текущую позицию курсора записи или воспроизведения устройства MCI.

0. szFile — заканчивающаяся нулём строка, содержащая имя устройства MCI или открываемого файла данных.

Примечание

Функция MCIWndCreate регистрирует класс окна MCIWnd и создаёт окно MCIWnd с использованием служебных программ MCI. Функция MCIWndCreate может быть использована для открытия устройства MCI или файла данных (например, файла с расширением .avi) и связать его с окном MCIWnd.

По умолчанию для дочернего окна устанавливаются стили WS_CHILD, WS_BORDER и WS_VISIBLE. Функция MCIWndCreate создаёт дочернее окно в том случае, если ей передаётся ненулевой дескриптор родительского окна. По умолчанию родительское окно имеет стили WS_OVERLAPPEDWINDOW и WS_VISIBLE. Функция MCIWndCreate создаёт родительское окно в том случае, если ей передаётся нулевой дескриптор родительского окна. Дескриптор окна, возвращаемый данной функцией, используется в макросах MCIWnd. Если приложение использует функцию MCIWndCreate оно может не использовать функцию MCIWndRegisterClass.

Описание данной функции содержится в файле заголовка vfw.h. При работе с данной функцией следует включить в проект библиотеку vfw32.lib.