Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Задает свойство на существующем порту уведомлений.
Синтаксис
typedef enum WHV_NOTIFICATION_PORT_PROPERTY_CODE
{
WHvNotificationPortPropertyPreferredTargetVp = 1,
WHvNotificationPortPropertyPreferredTargetDuration = 5,
} WHV_NOTIFICATION_PORT_PROPERTY_CODE;
typedef UINT64 WHV_NOTIFICATION_PORT_PROPERTY;
typedef PVOID WHV_NOTIFICATION_PORT_HANDLE;
HRESULT
WINAPI
WHvSetNotificationPortProperty(
_In_ WHV_PARTITION_HANDLE Partition,
_In_ WHV_NOTIFICATION_PORT_HANDLE PortHandle,
_In_ WHV_NOTIFICATION_PORT_PROPERTY_CODE PropertyCode,
_In_ WHV_NOTIFICATION_PORT_PROPERTY PropertyValue
);
Parameters
Partition
Дескриптор объекта секции.
PortHandle
Дескриптор до порта уведомлений, как возвращается WHvCreateNotificationPort.
PropertyCode
Указывает свойство, которое нужно задать, в качестве WHV_NOTIFICATION_PORT_PROPERTY_CODE значения.
PropertyValue
Указывает значение, которое необходимо назначить свойству, определяемом PropertyCode.
Возвращаемое значение
Если функция выполнена успешно, возвращается S_OKзначение.
Функция завершается ошибкой, если PropertyCode не является одним из поддерживаемых WHV_NOTIFICATION_PORT_PROPERTY_CODE значений, если PropertyValue оно не находится в диапазоне для свойства , например, целевой индекс виртуального процессора, который не является допустимым индексом или WHV_ANY_VP не PortHandle ссылается на допустимый порт уведомлений.
Remarks
Функция WHvSetNotificationPortProperty задает свойство для порта уведомлений, созданного с WHvCreateNotificationPortпомощью .
WHvNotificationPortPropertyPreferredTargetVp задает индекс виртуального процессора, который гипервизор предпочитает в качестве целевого объекта для уведомлений порта. Значение по умолчанию — WHV_ANY_VPэто значение, позволяющее гипервизору выбрать любой виртуальный процессор.
WHvNotificationPortPropertyPreferredTargetDuration задает длительность в 100-наносекундных единицах, для которых предпочтительный целевой виртуальный процессор остается целевым объектом сходства. Значение по умолчанию — WHV_NOTIFICATION_PORT_PREFERRED_DURATION_MAX.
Требования
| Requirement | Ценность |
|---|---|
| Минимальный поддерживаемый Windows | Windows 10 версии 20H2 (x64); Windows 11 версии 24H2, сборка 26100.3915 (Arm64) |
| Header | WinHvPlatform.h |
| Библиотека | WinHvPlatform.lib |
| DLL | WinHvPlatform.dll |
| Architecture | x64, Arm64 |