Класс CWinThread
Класс, представляющий поток исполнения в приложении.
Синтаксис
class CWinThread : public CCmdTarget
Участники
Открытые конструкторы
| Имя | Описание |
|---|---|
CWinThread::CWinThread |
Формирует объект CWinThread. |
Открытые методы
| Имя | Описание |
|---|---|
CWinThread::CreateThread |
Запускает выполнение CWinThread объекта. |
CWinThread::ExitInstance |
Переопределите, чтобы очистить при завершении потока. |
CWinThread::GetMainWnd |
Извлекает указатель на главное окно для потока. |
CWinThread::GetThreadPriority |
Возвращает приоритет текущего потока. |
CWinThread::InitInstance |
Переопределите для выполнения инициализации экземпляра потока. |
CWinThread::IsIdleMessage |
Проверяет наличие специальных сообщений. |
CWinThread::OnIdle |
Переопределите для выполнения обработки времени простоя для потока. |
CWinThread::PostThreadMessage |
Отправляет сообщение другому объекту CWinThread . |
CWinThread::PreTranslateMessage |
Фильтрует сообщения перед отправкой в функции TranslateMessage Windows и DispatchMessage. |
CWinThread::ProcessMessageFilter |
Перехватывает некоторые сообщения, прежде чем они достигают приложения. |
CWinThread::ProcessWndProcException |
Перехватывает все необработанные исключения, создаваемые обработчиками сообщений и команд потока. |
CWinThread::PumpMessage |
Содержит цикл сообщений потока. |
CWinThread::ResumeThread |
Уменьшает количество приостановки потока. |
CWinThread::Run |
Управление функцией для потоков с помощью насоса сообщений. Переопределите, чтобы настроить цикл сообщений по умолчанию. |
CWinThread::SetThreadPriority |
Задает приоритет текущего потока. |
CWinThread::SuspendThread |
Увеличивает число приостановки потока. |
Открытые операторы
| Имя | Описание |
|---|---|
CWinThread::operator HANDLE |
Извлекает дескриптор CWinThread объекта. |
Открытые члены данных
| Имя | Описание |
|---|---|
CWinThread::m_bAutoDelete |
Указывает, следует ли уничтожить объект при завершении потока. |
CWinThread::m_hThread |
Обработка текущего потока. |
CWinThread::m_nThreadID |
Идентификатор текущего потока. |
CWinThread::m_pActiveWnd |
Указатель на главное окно приложения контейнера при активном сервере OLE. |
CWinThread::m_pMainWnd |
Содержит указатель на главное окно приложения. |
Замечания
Основной поток выполнения обычно предоставляется объектом, производным от CWinApp; CWinApp является производным от CWinThread. Дополнительные CWinThread объекты позволяют нескольким потокам в данном приложении.
Существует два общих типа потоков, которые CWinThread поддерживают: рабочие потоки и потоки пользовательского интерфейса. Рабочие потоки не имеют насоса сообщений: например, поток, выполняющий фоновые вычисления в приложении электронной таблицы. Потоки пользовательского интерфейса имеют насос сообщений и обрабатывают сообщения, полученные из системы. CWinApp и классы, производные от него, являются примерами потоков пользовательского интерфейса. Другие потоки пользовательского интерфейса также могут быть производными непосредственно от CWinThread.
Объекты класса CWinThread обычно существуют в течение длительности потока. Если вы хотите изменить это поведение, задайте для m_bAutoDeleteFALSEпараметра .
Класс CWinThread необходим, чтобы сделать код полностью потокобезопасной и MFC. Локальные потоки данные, используемые платформой для поддержания сведений, относящихся к потоку, управляются объектами CWinThread . Из-за этой зависимости CWinThread от обработки локальных данных потока любой поток, использующий MFC, должен быть создан MFC. Например, поток, созданный функцией _beginthreadвремени выполнения, _beginthreadex не может использовать api MFC.
Чтобы создать поток, вызовите AfxBeginThread. Существует две формы в зависимости от того, требуется ли рабочий или пользовательский интерфейс. Если требуется поток пользовательского CWinThreadинтерфейса, передайте указатель на AfxBeginThreadCRuntimeClass производный класс. Если вы хотите создать рабочий поток, передайте AfxBeginThread указатель на управляющую функцию и параметр в управляющую функцию. Для рабочих потоков и потоков пользовательского интерфейса можно указать необязательные параметры, которые изменяют приоритет, размер стека, флаги создания и атрибуты безопасности. AfxBeginThread возвращает указатель на новый CWinThread объект.
Вместо вызова AfxBeginThreadможно создать производный CWinThreadобъект, а затем вызвать CreateThread. Этот двухэтапный метод построения полезен, если вы хотите повторно использовать CWinThread объект между последовательным созданием и завершением выполнения потоков.
Дополнительные сведения CWinThreadсм. в статьях "Многопоточность с помощью C++ и MFC", "Многопоточность": создание потоков пользовательского интерфейса, многопоточность: создание рабочих потоков и многопоточность: использование классов синхронизации.
Иерархия наследования
CWinThread
Требования
Заголовок.afxwin.h
CWinThread::CreateThread
Создает поток для выполнения в адресном пространстве вызывающего процесса.
BOOL CreateThread(
DWORD dwCreateFlags = 0,
UINT nStackSize = 0,
LPSECURITY_ATTRIBUTES lpSecurityAttrs = NULL);
Параметры
dwCreateFlags
Указывает дополнительный флаг, который управляет созданием потока. Этот флаг может содержать одно из двух значений:
CREATE_SUSPENDEDЗапустите поток с числом приостановки одного. Используйте,CREATE_SUSPENDEDесли вы хотите инициализировать все данные-членыCWinThreadобъекта, такие какm_bAutoDeleteили любые члены производного класса, перед запуском потока. После завершения инициализации используйтеCWinThread::ResumeThreadего для запуска потока. Поток не будет выполняться доCWinThread::ResumeThreadвызова.0 Запустите поток сразу после создания.
nStackSize
Задает размер в байтах стека для нового потока. Если значение равно 0, размер стека по умолчанию совпадает с размером основного потока процесса.
lpSecurityAttrs
Указывает на структуру SECURITY_ATTRIBUTES , указывающую атрибуты безопасности для потока.
Возвращаемое значение
Ненулевое значение, если поток успешно создан; в противном случае — 0.
Замечания
Используется AfxBeginThread для создания объекта потока и его выполнения на одном шаге. Используйте CreateThread , если вы хотите повторно использовать объект потока между последовательным созданием и завершением выполнения потоков.
CWinThread::CWinThread
Формирует объект CWinThread.
CWinThread();
Замечания
Чтобы начать выполнение потока, вызовите CreateThread функцию-член. Обычно вы создаете потоки, вызывая AfxBeginThreadэтот конструктор и CreateThread.
CWinThread::ExitInstance
Вызывается платформой из редко переопределенной Run функции-член, чтобы выйти из этого экземпляра потока или если вызов завершится InitInstance сбоем.
virtual int ExitInstance();
Возвращаемое значение
Код выхода потока; Значение 0 указывает на отсутствие ошибок и значения, превышающие 0, указывают на ошибку. Это значение можно получить путем вызова GetExitCodeThread.
Замечания
Не вызывайте эту функцию-член из любого места, но в функции-члене Run . Эта функция-член используется только в потоках пользовательского интерфейса.
Реализация этой функции по умолчанию удаляет CWinThread объект, если m_bAutoDelete есть TRUE. Переопределите эту функцию, если вы хотите выполнить дополнительную очистку при завершении потока. ExitInstance Реализация должна вызывать версию базового класса после выполнения кода.
CWinThread::GetMainWnd
Если приложение является сервером OLE, вызовите эту функцию, чтобы получить указатель на активное главное окно приложения, а не напрямую ссылаться на m_pMainWnd член объекта приложения.
virtual CWnd* GetMainWnd();
Возвращаемое значение
Эта функция возвращает указатель на один из двух типов окон. Если поток является частью сервера OLE и имеет объект, активный на месте внутри активного контейнера, эта функция возвращает CWinApp::m_pActiveWnd элемент CWinThread данных объекта.
Если в контейнере нет объекта, активного на месте, или приложение не является сервером OLE, эта функция возвращает m_pMainWnd элемент данных объекта потока.
Замечания
Для потоков пользовательского интерфейса это эквивалентно непосредственно ссылке на m_pActiveWnd член объекта приложения.
Если приложение не является сервером OLE, вызов этой функции эквивалентен непосредственно ссылке на m_pMainWnd член объекта приложения.
Переопределите эту функцию, чтобы изменить поведение по умолчанию.
CWinThread::GetThreadPriority
Возвращает текущий уровень приоритета потока данного потока.
int GetThreadPriority();
Возвращаемое значение
Текущий уровень приоритета потока в своем классе приоритета. Возвращаемое значение будет одним из следующих значений, перечисленных в списке с наивысшим приоритетом до наименьшего:
THREAD_PRIORITY_TIME_CRITICALTHREAD_PRIORITY_HIGHESTTHREAD_PRIORITY_ABOVE_NORMALTHREAD_PRIORITY_NORMALTHREAD_PRIORITY_BELOW_NORMALTHREAD_PRIORITY_LOWESTTHREAD_PRIORITY_IDLE
Дополнительные сведения об этих приоритетах см SetThreadPriority . в пакете SDK для Windows.
CWinThread::InitInstance
InitInstance Необходимо переопределить для инициализации каждого нового экземпляра потока пользовательского интерфейса.
virtual BOOL InitInstance();
Возвращаемое значение
Ненулевое значение, если инициализация выполнена успешно; в противном случае — 0.
Замечания
Как правило, вы переопределяете InitInstance выполнение задач, которые необходимо выполнить при первом создании потока.
Эта функция-член используется только в потоках пользовательского интерфейса. Инициализация рабочих потоков в управляемой функции, переданной AfxBeginThreadв .
CWinThread::IsIdleMessage
Переопределите эту функцию, чтобы не OnIdle вызываться после создания определенных сообщений.
virtual BOOL IsIdleMessage(MSG* pMsg);
Параметры
pMsg
Указывает на текущее обработанное сообщение.
Возвращаемое значение
Ненулевое значение, если OnIdle должно вызываться после обработки сообщения; в противном случае — значение 0.
Замечания
Реализация по умолчанию не вызывается OnIdle после избыточных сообщений мыши и сообщений, созданных за счет мигания.
Если приложение создало короткий таймер, OnIdle будет вызываться часто, вызывая проблемы с производительностью. Чтобы повысить производительность такого приложения, переопределите IsIdleMessage в производном классе приложения CWinAppна проверка для WM_TIMER сообщений следующим образом:
BOOL CMyWinApp::IsIdleMessage(MSG* pMsg)
{
if (!CWinApp::IsIdleMessage(pMsg) || pMsg->message == WM_TIMER)
return FALSE;
else
return TRUE;
}
Обработка WM_TIMER в этом режиме повышает производительность приложений, использующих короткие таймеры.
CWinThread::m_bAutoDelete
Указывает, следует ли CWinThread автоматически удалять объект при завершении потока.
BOOL m_bAutoDelete;
Замечания
Элемент m_bAutoDelete данных — это общедоступная переменная типа BOOL.
Значение m_bAutoDelete не влияет на то, как закрывается базовый дескриптор потока, но влияет на время закрытия дескриптора. Дескриптор потока всегда закрывается при CWinThread уничтожении объекта.
CWinThread::m_hThread
Дескриптор к потоку, подключенному к этому CWinThread.
HANDLE m_hThread;
Замечания
Элемент m_hThread данных — это общедоступная переменная типа HANDLE. Это допустимо только в том случае, если базовый объект потока ядра в настоящее время существует, и дескриптор еще не закрыт.
Деструктор CWinThread вызываетсяm_hThreadCloseHandle. TRUE Если m_bAutoDelete поток завершается, CWinThread объект уничтожается, что делает недействительными любые указатели на CWinThread объект и его переменные-члены. Может потребоватьсяm_hThread, чтобы элемент проверка значение выхода потока или ожидать сигнала. Чтобы сохранить CWinThread объект и его m_hThread член во время выполнения потока и после его завершения, установите значение m_bAutoDeleteFALSE перед продолжением выполнения потока. В противном случае поток может завершиться, уничтожить CWinThread объект и закрыть дескриптор перед его использованием. При использовании этого метода вы несете ответственность за удаление CWinThread объекта.
CWinThread::m_nThreadID
Идентификатор потока, подключенного к этому CWinThread.
DWORD m_nThreadID;
Замечания
Элемент m_nThreadID данных — это общедоступная переменная типа DWORD. Это допустимо только в том случае, если в настоящее время существует базовый объект потока ядра.
Также см. замечания о m_hThread времени существования.
Пример
Пример см. в примере AfxGetThread.
CWinThread::m_pActiveWnd
Используйте этот элемент данных для хранения указателя на активный объект окна потока.
CWnd* m_pActiveWnd;
Замечания
Библиотека классов Microsoft Foundation автоматически завершает поток при закрытии окна m_pActiveWnd . Если этот поток является основным потоком для приложения, приложение также будет завершено. Если этот элемент данных является NULL, активное окно для объекта приложения CWinApp будет унаследовано. m_pActiveWnd — общедоступная переменная типа CWnd*.
Как правило, эта переменная-член устанавливается при переопределении InitInstance. В рабочем потоке значение этого элемента данных наследуется от родительского потока.
CWinThread::m_pMainWnd
Используйте этот элемент данных для хранения указателя на главный объект окна потока.
CWnd* m_pMainWnd;
Замечания
Библиотека классов Microsoft Foundation автоматически завершает поток при закрытии окна m_pMainWnd . Если этот поток является основным потоком для приложения, приложение также будет завершено. Если этот элемент данных является NULL, главное окно объекта приложения CWinApp будет использоваться для определения момента завершения потока. m_pMainWnd — общедоступная переменная типа CWnd*.
Как правило, эта переменная-член устанавливается при переопределении InitInstance. В рабочем потоке значение этого элемента данных наследуется от родительского потока.
CWinThread::OnIdle
Переопределите эту функцию-член для выполнения обработки бездействия.
virtual BOOL OnIdle(LONG lCount);
Параметры
lCount
Счетчик увеличивается каждый раз, OnIdle когда очередь сообщений потока пуста. Это число сбрасывается до 0 при каждом обработке нового сообщения. Параметр можно использовать lCount для определения относительной продолжительности времени простоя потока без обработки сообщения.
Возвращаемое значение
Ненулевое значение для получения больше времени простоя обработки; Значение 0, если больше времени бездействия не требуется.
Замечания
OnIdle вызывается в цикле сообщений по умолчанию, когда очередь сообщений потока пуста. Используйте переопределение для вызова собственных фоновых задач бездействия обработчика.
OnIdle должен возвращать значение 0, чтобы указать, что не требуется дополнительное время простоя. Параметр lCount увеличивается каждый раз OnIdle , когда очередь сообщений пуста и сбрасывается до 0 при каждом обработке нового сообщения. Вы можете вызывать различные подпрограммы простоя в зависимости от этого количества.
Реализация этой функции-члена по умолчанию освобождает временные объекты и неиспользуемые библиотеки динамического канала из памяти.
Эта функция-член используется только в потоках пользовательского интерфейса.
Так как приложение не может обрабатывать сообщения, пока OnIdle не возвращается, не выполняйте длительные задачи в этой функции.
CWinThread::operator HANDLE
Извлекает дескриптор CWinThread объекта.
operator HANDLE() const;
Возвращаемое значение
В случае успешного выполнения дескриптор объекта потока; NULLв противном случае .
Замечания
Используйте дескриптор для прямого вызова API Windows.
CWinThread::PostThreadMessage
Вызывается для публикации определяемого пользователем сообщения другому CWinThread объекту.
BOOL PostThreadMessage(
UINT message,
WPARAM wParam,
LPARAM lParam);
Параметры
message
Идентификатор определяемого пользователем сообщения.
wParam
Первый параметр сообщения.
lParam
Второй параметр сообщения.
Возвращаемое значение
Имеет ненулевое значение в случае успешного выполнения, иначе — 0.
Замечания
Размещенное сообщение сопоставляется с соответствующим обработчиком сообщений макросом ON_THREAD_MESSAGEкарты сообщений.
Примечание.
При вызове PostThreadMessageсообщение помещается в очередь сообщений потока. Тем не менее, поскольку сообщения, опубликованные таким образом, не связаны с окном, MFC не отправляет их в обработчики сообщений или команд. Чтобы обрабатывать эти сообщения, переопределите PreTranslateMessage() функцию производного CWinAppкласса и обработайте сообщения вручную.
CWinThread::PreTranslateMessage
Переопределите эту функцию, чтобы фильтровать сообщения окна перед отправкой в функции TranslateMessage Windows и DispatchMessage.
virtual BOOL PreTranslateMessage(MSG* pMsg);
Параметры
pMsg
Указывает на структуруMSG, содержащую сообщение для обработки.
Возвращаемое значение
Ненулевое значение, если сообщение было полностью обработано PreTranslateMessage и не должно обрабатываться дальше. Ноль, если сообщение должно обрабатываться обычным образом.
Замечания
Эта функция-член используется только в потоках пользовательского интерфейса.
CWinThread::ProcessMessageFilter
Функция перехватчика платформы вызывает эту функцию-член для фильтрации и реагирования на определенные сообщения Windows.
virtual BOOL ProcessMessageFilter(
int code,
LPMSG lpMsg);
Параметры
code
Задает код перехватчика. Эта функция-член использует код для определения способа обработки lpMsg.
lpMsg
Указатель на структуру WindowsMSG.
Возвращаемое значение
Ненулевое значение, если сообщение обрабатывается; в противном случае — 0.
Замечания
Функция перехватчика обрабатывает события перед отправкой в обычную обработку сообщений приложения.
Если переопределить эту расширенную функцию, обязательно вызовите версию базового класса для поддержания обработки перехватчика платформы.
CWinThread::ProcessWndProcException
Платформа вызывает эту функцию-член всякий раз, когда обработчик не перехватывает исключение, возникающее в одном из сообщений или обработчиков команд потока.
virtual LRESULT ProcessWndProcException(
CException* e,
const MSG* pMsg);
Параметры
e
Указывает на необработанное исключение.
pMsg
Указывает на MSG структуру , содержащую сведения о сообщении Windows, которое привело к возникновению исключения платформы.
Возвращаемое значение
-1, если WM_CREATE создается исключение; в противном случае — 0.
Замечания
Не вызывайте эту функцию-член напрямую.
Реализация этой функции-члена по умолчанию обрабатывает только исключения, созданные из следующих сообщений:
| Команда | Действие |
|---|---|
WM_CREATE |
Не. |
WM_PAINT |
Проверьте затронутую окно, чтобы предотвратить создание другого WM_PAINT сообщения. |
Переопределите эту функцию-член, чтобы обеспечить глобальную обработку исключений. Вызовите базовую функциональность, только если вы хотите отобразить поведение по умолчанию.
Эта функция-член используется только в потоках с насосом сообщений.
CWinThread::PumpMessage
Содержит цикл сообщений потока.
virtual BOOL PumpMessage();
Замечания
PumpMessage содержит цикл сообщений потока. PumpMessage вызывается CWinThread для перекачки сообщений потока. Можно вызвать PumpMessage непосредственно для принудительной обработки сообщений или переопределить PumpMessage его поведение по умолчанию.
Для PumpMessage расширенных пользователей рекомендуется вызывать напрямую и переопределять его поведение по умолчанию.
CWinThread::ResumeThread
Вызывается для возобновления выполнения потока, приостановленного SuspendThread функцией-членом или потоком, созданным с помощью флага CREATE_SUSPENDED .
DWORD ResumeThread();
Возвращаемое значение
Предыдущее число приостановки потока в случае успешного выполнения; 0xFFFFFFFF Иначе. Если возвращаемое значение равно нулю, текущий поток не был приостановлен. Если возвращаемое значение равно одному, поток был приостановлен, но теперь перезапущен. Любое возвращаемое значение больше одного означает, что поток остается приостановленным.
Замечания
Количество приостановки текущего потока уменьшается на один. Если число приостановки уменьшается до нуля, поток возобновляет выполнение; в противном случае поток остается приостановленным.
CWinThread::Run
Предоставляет цикл сообщений по умолчанию для потоков пользовательского интерфейса.
virtual int Run();
Возвращаемое значение
Значение int , возвращаемое потоком. Это значение можно получить путем вызова GetExitCodeThread.
Замечания
Run получает и отправляет сообщения Windows, пока приложение не получит WM_QUIT сообщение. Если в настоящее время очередь сообщений потока не содержит сообщений, Run вызовы OnIdle для выполнения обработки бездействия. Входящие сообщения переходят в PreTranslateMessage функцию-член для специальной обработки, а затем в функцию TranslateMessage Windows для стандартного перевода клавиатуры. Наконец, DispatchMessage вызывается функция Windows.
Run редко переопределяется, но его можно переопределить для реализации специального поведения.
Эта функция-член используется только в потоках пользовательского интерфейса.
CWinThread::SetThreadPriority
Эта функция задает уровень приоритета текущего потока в своем классе приоритета.
BOOL SetThreadPriority(int nPriority);
Параметры
nPriority
Задает новый уровень приоритета потока в своем классе приоритета. Этот параметр должен быть одним из следующих значений, перечисленных в списке с наивысшим приоритетом до наименьшего:
THREAD_PRIORITY_TIME_CRITICALTHREAD_PRIORITY_HIGHESTTHREAD_PRIORITY_ABOVE_NORMALTHREAD_PRIORITY_NORMALTHREAD_PRIORITY_BELOW_NORMALTHREAD_PRIORITY_LOWESTTHREAD_PRIORITY_IDLE
Дополнительные сведения об этих приоритетах см SetThreadPriority . в пакете SDK для Windows.
Возвращаемое значение
Ненулевое значение, если функция выполнена успешно; в противном случае — 0.
Замечания
Его можно вызывать только после CreateThread успешного возвращения.
CWinThread::SuspendThread
Увеличивает число приостановки текущего потока.
DWORD SuspendThread();
Возвращаемое значение
Предыдущее число приостановки потока в случае успешного выполнения; 0xFFFFFFFF Иначе.
Замечания
Если любой поток имеет число приостановки выше нуля, этот поток не выполняется. Поток можно возобновить, вызвав функцию-член ResumeThread .
См. также
CCmdTarget Класса
Диаграмма иерархии
CWinApp Класса
CCmdTarget Класса
Обратная связь
Ожидается в ближайшее время: в течение 2024 года мы постепенно откажемся от GitHub Issues как механизма обратной связи для контента и заменим его новой системой обратной связи. Дополнительные сведения см. в разделе https://aka.ms/ContentUserFeedback.
Отправить и просмотреть отзыв по