Русский справочник по Win32 API

Значение	Пояснение
HEAP _ NO _ SERIALIZE	Определяет, что взаимное исключение не будет использоваться, когда функция получает доступ к куче. Для дополнительной информации смотрите раздел "Комментарии" в описании функции HeapCreate .

lpMem - указывает на блок памяти, чей размер функция получает. Указатель возвращается функциями HeapAlloc или HeapReAlloc .

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

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

В случае неудачи возвращается 0 xFFFFFFFF . Функция не вызывает SetLastError . Приложение не может вызвать GetLastError для дополнительной информации об ошибке.

См. также

GetProcessHeap, HeapAlloc, HeapCreate, HeapDestroy, HeapFree, HeapReAlloc, SetLastError .

Подбор цветов

CreateColorSpace

Функция CreateColorSpace создает логическое цветовое пространство.

HCOLORSPACE CreateColorSpace (

LPLOGCOLORSPACE lpLogColorSpace

);

Параметры

lpLogColorSpace - указывает на структуру типа LOGCOLORSPACE .

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

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

В случае неудачи возвращается NULL

Комментарии

Когда у вас больше нет необходимости в цветовом пространстве, вызовите функцию DeleteObject для его удаления.

См. также

DeleteObject, LOGCOLORSPACE .

Мультимедиа таймеры

TimeProc

Функция TimeProc является функцией обратного вызова, которая вызывается один раз по завершению одиночного события таймера или периодически по завершению периодических событий.

void CALLBACK TimeProc (

UINT uID,

UINT uMsg,

DWORD dwUser,

DWORD dw1,

DWORD dw2

);

TimeProc является "заполнителем" для имени определяемой приложением функции.

Параметры

uID - идентификатор события таймера. Этот идентификатор был возвращен функцией timeSetEvent при установке события.

uMsg - зарезервирован. Не используется.

dwUser - пользовательские данные, представленные значением параметра dwUser функции timeSetEvent.

dw1 - зарезервирован. Не используется.

dw2 - зарезервирован. Не используется.

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

Функция не возвращает значения.

Комментарии

Приложения не должны вызывать определяемые системой функции внутри функции обратного вызова, кроме PostMessage, timeGetSystemTime, timeGetTime, timeSetEvent, timeKillEvent, midiOutShortMsg, midiOutLongMsg и OutputDebugString.

Требования

Windows NT /2000/ XP : Включена в Windows NT 3.1 и выше.

Windows 95/98/ Me : Включена в Windows 95 и выше.

Заголовок: Объявлена в Mmsystem.h; подключать Windows.h.

См . также

timeSetEvent, PostMessage, timeGetSystemTime, timeGetTime, timeKillEvent, midiOutShortMsg, midiOutLongMsg, OutputDebugString.

timeBeginPeriod

Функция timeBeginPeriod устанавливает минимальное разрешение мультимедиа таймера для приложения или драйвера устройства.

MMRESULT timeBeginPeriod (

UINT uPeriod

);

Параметры

uPeriod - минимальное разрешение таймера в миллисекундах для приложения или драйвера устройства.

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

В случае успеха возвращается TIMERR_NOERROR или TIMERR_NOCANDO, если разрешение, заданное значением параметра uPeriod , находится вне допустимого диапазона.

Комментарии

Вызовите эту функцию непосредственно перед использованием сервисов мультимедиа таймера, и вызовите функцию timeEndPeriod после завершения использования сервисов мультимедиа таймера.

Вы должны каждому вызову timeBeginPeriod сопоставить вызов timeEndPeriod , определив одинаковое минимальное разрешение в обоих вызовах. Приложение может вызывать функцию timeBeginPeriod многократно, до тех пор, пока каждому ее вызову сопоставлен ответный вызов timeEndPeriod .

Требования

Windows NT/2000/XP : Включена в Windows NT 3.1 и выше.

Windows 95/98/Me : Включена в Windows 95 и выше.

Заголовок: Объявлена в Mmsystem.h ; подключать Windows.h.

Библиотека: Используйте Winmm.lib.

См. также