OID_SWITCH_PORT_PROPERTY_ENUM
Hyper-V 拡張可能スイッチ拡張機能は、配列を取得する OID_SWITCH_PORT_PROPERTY_ENUM のオブジェクト識別子 (OID) メソッド要求を発行します。 この配列には、指定した条件に一致するプロビジョニング済みのポート ポリシーが含まれています。 配列内の各要素は、指定された拡張可能スイッチ ポートのポリシーのプロパティを指定します。
NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、バッファーへのポインターが含まれています。 このバッファーには、次のデータが含まれています：
指定したポートのポリシー リストのパラメーターを指定する NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 構造体。
NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO 構造体の配列。 これらの各構造体には、拡張可能スイッチ ポート ポリシーのプロパティに関する情報が含まれています。
注NumProperties メンバー NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 構造体内) が 0 に設定されている場合、 NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO 構造体は返されません。
解説
OID_SWITCH_PORT_PROPERTY_ENUMの OID メソッド要求を発行する前に、拡張可能スイッチ拡張機能は次のガイドラインに従う必要があります：
拡張機能は、拡張可能スイッチのプロトコル エッジが OID_SWITCH_PORT_CREATE 要求を発行した後、 OID_SWITCH_PORT_TEARDOWN 要求を発行する前にのみ、 OID_SWITCH_PORT_PROPERTY_ENUM 要求を発行できます。
拡張機能は、 NdisFOidRequest を呼び出してOID_SWITCH_PORT_PROPERTY_ENUM 要求を発行する前に ReferenceSwitchPort を呼び出す必要があります。 これにより、OID 要求が完了するまで、指定したポートが削除されなくなります。
OID 要求が完了した後、拡張機能は DereferenceSwitchPort を呼び出す必要があります。 拡張機能は、OID 要求が NDIS_STATUS_SUCCESS で完了したかどうかに関係なく、この関数を呼び出す必要があります。
OID_SWITCH_PORT_PROPERTY_ENUM OID は、Hyper-V 拡張可能スイッチがアクティブ化を完了したときにのみ発行する必要があります。 詳細については、 Hyper-V 拡張可能スイッチ構成のクエリ を参照してください。
注 拡張機能は、 OID_SWITCH_PORT_PROPERTY_ENUM の OID メソッド要求を受信する場合は、OID 要求を完了してはなりません。 代わりに、 NDISFOidRequest を呼び出して、OID 要求を拡張可能スイッチ ドライバー スタックに転送する必要があります。
状態コードを返します
拡張可能スイッチの下位ミニポート エッジは、 OID_SWITCH_PORT_PROPERTY_ENUM の OID クエリ要求を完了し、次のいずれかの状態コードを返します。
| 状態コード | 説明 |
|---|---|
NDIS_STATUS_SUCCESS |
OID 要求は正常に完了しました。 |
要件
バージョン |
NDIS 6.30 以降でサポートされています。 |
ヘッダー |
Ntddndis.h (Ndis.h を含む) |
関連項目
NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO