WHvPostVirtualProcessorSynicMessage

Bir sanal işlemciye yapay kesme denetleyicisi (SynIC) iletisi yayınlar.

Sözdizimi

#define WHV_SYNIC_MESSAGE_SIZE  256

HRESULT
WINAPI
WHvPostVirtualProcessorSynicMessage(
    _In_ WHV_PARTITION_HANDLE Partition,
    _In_ UINT32 VpIndex,
    _In_ UINT32 SintIndex,
    _In_reads_bytes_(MessageSizeInBytes) const VOID* Message,
    _In_ UINT32 MessageSizeInBytes
    );

Parameters

Partition

Bölüm nesnesi için tanıtıcı.

VpIndex

Hedef sanal işlemcinin dizinini belirtir.

SintIndex

İletinin teslimi için yapay kesme kaynağını (SINT) belirtir.

Message

Gönderilecek ileti yükünü belirtir.

MessageSizeInBytes

Messageboyutunu bayt cinsinden belirtir. Sıfırdan büyük ve (256) büyük WHV_SYNIC_MESSAGE_SIZE olmamalıdır.

Dönüş Değeri

İşlev başarılı olursa, dönüş değeri olur S_OK.

işlevi değerinden WHV_SYNIC_MESSAGE_SIZEbüyükse MessageSizeInBytes döndürürE_INVALIDARG. Hedef sanal işlemcinin SINT ileti yuvası teslim edilmemiş bir ileti tarafından zaten kaplanmışsa, işlevi döndürür HRESULT_FROM_WIN32(ERROR_HV_OBJECT_IN_USE).

Açıklamalar

İşlev, WHvPostVirtualProcessorSynicMessage ileti hiper yönetici tarafından gönderilmiş gibi belirtilen SINT üzerindeki hedef sanal işlemcinin SynIC ileti sayfasına bir ileti teslim eder. İleti ilgili SINT ileti yuvasına yazılır ve sanal işlemciye bu SINT aracılığıyla bildirim gönderilir.

Her SINT'in tek bir ileti yuvası vardır. Bu SINT üzerindeki önceki ileti henüz konuk tarafından tüketilmemişse, çağrı ile ERROR_HV_OBJECT_IN_USEbaşarısız olur; konuk önceki iletiyi kabul ettikten sonra çağıranın yeniden denemesi gerekir.

Requirements

Requirement Değer
Desteklenen en düşük Windows Windows 10, sürüm 20H2 (x64); Windows 11, sürüm 24H2, derleme 26100.3915 (Arm64)
Header WinHvPlatform.h
Kütüphane WinHvPlatform.lib
DLL WinHvPlatform.dll
Architecture x64, Arm64

Ayrıca bakınız

  • Last updated on