WHvSetNotificationPortProperty

既存の通知ポートのプロパティを設定します。

構文

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値の 1 つでない場合、PropertyValueが有効なインデックスでもWHV_ANY_VPでもないターゲット仮想プロセッサ インデックスなど、プロパティの範囲外にある場合、またはPortHandleが有効な通知ポートを参照していない場合、関数は失敗します。

Remarks

WHvSetNotificationPortProperty関数は、WHvCreateNotificationPortで作成された通知ポートのプロパティを設定します。

WHvNotificationPortPropertyPreferredTargetVp は、ハイパーバイザーがポートの通知のターゲットとして優先する仮想プロセッサのインデックスを設定します。 既定値は WHV_ANY_VP であり、ハイパーバイザーは仮想プロセッサを選択できます。

WHvNotificationPortPropertyPreferredTargetDuration は、優先ターゲット仮想プロセッサがアフィニティ ターゲットのままである期間を 100 ナノ秒単位で設定します。 既定値は WHV_NOTIFICATION_PORT_PREFERRED_DURATION_MAX です。

Requirements

こちらも参照ください

• WHvCreateNotificationPort
• WHvDeleteNotificationPort
• 通知ポートのデータ型
• Windows Hypervisor Platform API Definitions