次の方法で共有


OID_SWITCH_PROPERTY_ADD

Hyper-V 拡張可能スイッチのプロトコル エッジは、スイッチ ポリシー プロパティの追加について拡張可能スイッチ拡張機能に通知するOID_SWITCH_PROPERTY_ADDのオブジェクト識別子 (OID) セット要求を発行します

NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、バッファーへのポインターが含まれています。 このバッファーには、次のデータが含まれています。

  • 拡張可能スイッチ ポリシーの識別と種類を指定する NDIS_SWITCH_PROPERTY_PARAMETERS 構造体。

  • 拡張可能スイッチ ポリシーのパラメーターを含むプロパティ バッファー。 プロパティ バッファーには、NDIS_SWITCH_PROPERTY_PARAMETERS 構造体の PropertyType メンバーに基づく構造体が含まれています。

    Windows Server 2012 以降では、PropertyType メンバーを NdisSwitchPropertyTypeCustom に設定し、プロパティ バッファーに NDIS_SWITCH_PROPERTY_CUSTOM 構造体を含める必要があります。

備考

転送拡張機能は、OID_SWITCH_PROPERTY_ADDの OID セット要求を処理できます。 その他のすべての種類の拡張機能は、拡張可能スイッチ ドライバー スタック 次の拡張機能に OID 要求を転送する NdisFOidRequest を呼び出す必要があります。

拡張機能は、OID 要求のNDIS_STATUS_DATA_NOT_ACCEPTEDを返すことによって、switch プロパティの追加を拒否できます。 たとえば、拡張機能が更新されたポリシーをスイッチに適用するためにリソースを割り当てることができない場合は、追加要求を拒否する必要があります。

拡張機能が他のNDIS_STATUS_Xxx エラー 状態コードを返した場合、作成通知も拒否されます。 ただし、NDIS_STATUS_RESOURCESの返しなど、一時的なシナリオの状態コードを返すと、作成通知が再試行される可能性があります。

拡張機能が OID 要求を拒否しない場合は、要求が完了したときに状態を監視する必要があります。 拡張機能は、OID 要求が拡張可能スイッチ制御パスの基になる拡張機能によって拒否されたか、拡張可能スイッチ インターフェイスによって拒否されたかを判断するためにこれを行う必要があります。

OID_SWITCH_PROPERTY_ADDの OID セット要求を処理する方法のガイドラインについては、「スイッチ ポリシー の管理を参照してください。

戻り値の状態コード

転送拡張機能がOID_SWITCH_PROPERTY_ADDの OID セット要求を完了すると、次のいずれかの状態コードが返されます。

状態コード 形容

NDIS_STATUS_DATA_NOT_ACCEPTED

拡張機能は、ポリシーの追加通知の切り替えを拒否しました。

NDIS_STATUS_FAILURE

OID 要求は、他の理由で失敗しました。

拡張機能がOID_SWITCH_PROPERTY_ADDの OID セット要求を完了しない場合、要求は拡張可能スイッチの基になるミニポート エッジによって完了します。 ミニポート エッジは、次の状態コードを返します。

状態コード 形容

NDIS_STATUS_SUCCESS

OID 要求が正常に完了しました。

必要条件

バージョン

NDIS 6.30 以降でサポートされています。

ヘッダ

Ntddndis.h (Ndis.h を含む)

関連項目


NDIS_OID_REQUEST

NDIS_SWITCH_PROPERTY_CUSTOM

NDIS_SWITCH_PROPERTY_PARAMETERS

NdisFOidRequest