Функция GetProcessAffinityMask


Функция GetProcessAffinityMask извлекает маску родственного процесса для заданного процесса и системную маску родственности для системы.

Синтаксис

BOOL GetProcessAffinityMask(

HANDLE hProcess,               // дескриптор процесса

LPDWORD lpProcessAffinityMask, // маска родственного процесса

LPDWORD lpSystemAffinityMask   // системная родственная маска

);

Параметры

hProcess

[in] Дескриптор процесса, маска родственности которого требуется

Windows NT/2000/XP: этот дескриптор должен иметь права доступа PROCESS_QUERY_INFORMATION. Для получения дополнительной информации, см. статью Защита процесса и права доступа.

lpProcessAffinityMask

[out] Указатель на переменную, которая получает маску родственности для заданного процесса.

lpSystemAffinityMask

[out] Указатель на переменную, которая получает маску родственности для системы.

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

Если функция завершается успешно, величина возвращаемого значения - не ноль.

Windows NT/2000/XP: После успешного завершения, функция устанавливает переменные двойного слова (DWORD), указанные параметрами lpProcessAffinityMask и lpSystemAffinityMask в соответствующие маски родственности.

Windows 95/98/Me: После успешного завершения, функция устанавливает переменные двойного слова (DWORD), указанные параметрами lpProcessAffinityMask и lpSystemAffinityMask в одно значение.

Если функция завершается ошибкой, величина возвращаемого значения - ноль, а значения переменных двойного слова (DWORD), указанных параметрами lpProcessAffinityMask и lpSystemAffinityMask не определены. Чтобы получать дополнительные данные об ошибках, вызовите GetLastError.

Замечания

Маска родственного процесса - это битовый вектор, в котором каждый бит обозначает процессоры, на которых разрешается запуск процесса. Системная маска родственности - это битовый вектор, в котором каждый бит обозначает процессоры, которые конфигурированы в систему.

Маска родственного процесса - собственное подмножество системной маски родственности. Процесс только дается возможность, чтобы запуститься на процессорах, сконфигурированных в систему.

Смотри также

Краткий обзор Процессы и потоки, Функции, используемые процессами и потоками, SetProcessAffinityMask, SetThreadAffinityMask

Размещение и совместимость GetProcessAffinityMask

Windows. NET Server

Да

Windows XP

Да

Windows 2000

Да

Windows NT

Да

Windows Me

Да

Windows 98

Да

Windows 95

Да

Используемая библиотека

Kernel32.lib

Заголовочный файл

 

- объявлено в

Winbase.h

- включено в

Windows.h

Unicode

Нет

Замечания по платформе

Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz