Hyper-V 拡張可能スイッチ拡張機能は、配列を取得するOID_SWITCH_PORT_PROPERTY_ENUMのオブジェクト識別子 (OID) メソッド要求を発行します。 この配列には、指定された条件に一致するプロビジョニング済みポート ポリシーが含まれています。 配列内の各要素は、指定された拡張可能スイッチ ポートのポリシーのプロパティを指定します。
NDIS_OID_REQUEST 構造体の InformationBuffer メンバーには、バッファーへのポインターが含まれています。 このバッファーには、次のデータが含まれています。
指定したポートのポリシー列挙のパラメーターを指定する NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 構造体。
NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO 構造体の配列。 これらの各構造体には、拡張可能スイッチ ポート ポリシーのプロパティに関する情報が含まれています。
メモNDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS 構造体の NumProperties メンバーが 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要求を発行できます。
この拡張機能は、OID_SWITCH_PORT_PROPERTY_ENUM要求 発行するために NdisFOidRequest呼び出す前に、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 を含む) |
関連項目
dereferenceSwitchPortの
NDIS_SWITCH_PORT_PROPERTY_ENUM_INFO
NDIS_SWITCH_PORT_PROPERTY_ENUM_PARAMETERS
NdisFOidRequestの
Hyper-V 拡張可能スイッチ構成 のクエリの
ReferenceSwitchPortの