Share via

HvCallPostMessage

  • Статья

Вызов Хвкаллпостмессаже пытается отправить сообщение (то есть асинхронно) в указанное соединение, которое имеет связанный порт назначения. Если сообщение успешно Опубликовано, оно будет поставлено в очередь для доставки на виртуальный процессор в пределах секции, связанной с портом.

Интерфейс

HV_STATUS
HvCallPostMessage(
   _In_ HV_CONNECTION_ID ConnectionId,
   _In_ HV_MESSAGE_TYPE MessageType,
   _In_ UINT32 PayloadSize,
   _In_reads_bytes_(PayloadSize) PCVOID Message
   );

Код вызова

0x005C Простого

Входные параметры

Имя Offset Размер Предоставленные сведения
ConnectionId 0 4 Указывает идентификатор соединения.
рсвдз 4 4
MessageType 8 4 Указывает тип сообщений, который будет отображаться в заголовке сообщения. Вызывающий объект может указать любой 32-разрядный тип сообщений, наиболее значимый бит которого удаляется, за исключением нуля.
PayloadSize 12 4 Указывает число байтов, включаемых в сообщение.
Message 16 240 СеЦифиес полезные данные сообщения — до 240 байт. Только первые n байтов фактически отправляются в секцию назначения, где n указывается в параметре Пайлоадсизе.

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

Код состояния Условие возникновения ошибки
HV_STATUS_ACCESS_DENIED Секция вызывающего объекта не обладает привилегией сообщений.
HV_STATUS_INVALID_CONNECTION_ID Указан недопустимый идентификатор соединения.
HV_STATUS_INVALID_PORT_ID Порт, связанный с указанным соединением, был удален.
Порт, связанный с указанным соединением, принадлежит к разделу, который не находится в состоянии "активно".
Порт, связанный с указанным соединением, не является портом типа "Message".
HV_STATUS_INVALID_PARAMETER Задан наиболее значимый бит указанного типа сообщений.
Параметр MessageType задает нулевое значение.
Указанный размер полезной нагрузки превышает 240 байт.
HV_STATUS_INSUFFICIENT_BUFFERS У порта нет доступных буферов сообщений гостя.
HV_STATUS_INVALID_VP_INDEX Целевой президент больше не существует, или нет доступных ВПС, на которые может быть отправлено сообщение.
HV_STATUS_INVALID_SYNIC_STATE Синик целевого президента отключен и не может принимать отправленные сообщения.
Страница SIM-карты целевого президента отключена.