次の方法で共有

NDIS_SWITCH_FEATURE_STATUS_PARAMETERS構造体 (ntddndis.h)

  • [アーティクル]

NDIS_SWITCH_FEATURE_STATUS_PARAMETERS 構造体は、拡張可能スイッチのカスタム状態情報のパラメーター Hyper-V 指定します。 この情報は、機能の状態 情報と呼ばれます。 この情報の形式は、独立系ソフトウェア ベンダー (ISV) によって定義されます。

状態情報は、OID_SWITCH_FEATURE_STATUS_QUERYのオブジェクト識別子 (OID) メソッド要求を通じて返される NDIS_SWITCH_FEATURE_STATUS_CUSTOM 構造体を通じて指定されます。

構文

typedef struct _NDIS_SWITCH_FEATURE_STATUS_PARAMETERS {
  NDIS_OBJECT_HEADER                       Header;
  ULONG                                    Flags;
  NDIS_SWITCH_FEATURE_STATUS_TYPE          FeatureStatusType;
  NDIS_SWITCH_OBJECT_ID                    FeatureStatusId;
  NDIS_SWITCH_OBJECT_INSTANCE_ID           FeatureStatusInstanceId;
  NDIS_SWITCH_OBJECT_VERSION               FeatureStatusVersion;
  NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION SerializationVersion;
  ULONG                                    FeatureStatusBufferOffset;
  ULONG                                    FeatureStatusBufferLength;
} NDIS_SWITCH_FEATURE_STATUS_PARAMETERS, *PNDIS_SWITCH_FEATURE_STATUS_PARAMETERS;

メンバーズ

Header

NDIS_SWITCH_FEATURE_STATUS_PARAMETERS 構造体の型、リビジョン、およびサイズ。 このメンバーは、NDIS_OBJECT_HEADER 構造体として書式設定されます。

ヘッダー の Type メンバーを NDIS_OBJECT_TYPE_DEFAULT に設定する必要があります。 NDIS_SWITCH_FEATURE_STATUS_PARAMETERS 構造体のバージョンを指定するには、Header の Revision メンバーを次の値に設定する必要があります。

NDIS_SWITCH_FEATURE_STATUS_PARAMETERS_REVISION_1

NDIS 6.30 以降の元のバージョン。

Size メンバーをNDIS_SIZEOF_NDIS_SWITCH_FEATURE_STATUS_PARAMETERS_REVISION_1に設定します。

Flags

フラグのビットごとの または を含む ULONG 値。 このメンバーは NDIS 用に予約されています。

FeatureStatusType

拡張可能スイッチの機能状態情報の種類を指定する NDIS_SWITCH_FEATURE_STATUS_TYPE 列挙値。

注 NDIS 6.30 以降では、このメンバーは NdisSwitchFeatureStatusTypeCustom に設定する必要があります。
 

FeatureStatusId

拡張可能スイッチの機能状態情報を識別する GUID 値。

この値は、機能ステータス情報のマネージド オブジェクト形式 (MOF) クラス定義で定義されます。 詳細については、「カスタム スイッチ プロパティの定義と登録 をする」を参照してください。

FeatureStatusInstanceId

拡張可能スイッチの機能状態情報のインスタンスを識別するNDIS_SWITCH_OBJECT_INSTANCE_ID値。

FeatureStatusVersion

拡張可能スイッチの機能状態情報のバージョンを識別するNDIS_SWITCH_OBJECT_VERSION値。 この値は、機能ステータス情報の MOF クラス定義で定義されます。

SerializationVersion

機能の状態情報のシリアル化された状態情報の形式バージョンを識別するNDIS_SWITCH_OBJECT_SERIALIZATION_VERSION値。 このデータは、プロパティを定義した MOF ファイルから拡張機能によってアクセスするためにシリアル化されます。

Windows Server 2012 の場合、SerializationVersion メンバーを NDIS_SWITCH_OBJECT_SERIALIZATION_VERSION_1 に設定する必要があります。
 

FeatureStatusBufferOffset

NDIS_SWITCH_FEATURE_STATUS_PARAMETERS 構造体に続く機能ステータス バッファーへのオフセットをバイト単位で指定する ULONG 値。 状態バッファーには、NDIS_SWITCH_FEATURE_STATUS_CUSTOM 構造体が含まれています。

オフセットは、NDIS_SWITCH_FEATURE_STATUS_PARAMETERS 構造体の先頭から NDIS_SWITCH_FEATURE_STATUS_CUSTOM 構造体の先頭まで測定されます。

FeatureStatusBufferLength

機能状態バッファーのサイズをバイト単位で指定する ULONG 値。

備考

NDIS_SWITCH_FEATURE_STATUS_PARAMETERS 構造体は、OID_SWITCH_FEATURE_STATUS_QUERYの OID メソッド要求で使用されます。 この OID 要求は、OID 要求に関連付けられている情報バッファー内の次の構造体を返します。

  • 拡張可能スイッチの機能状態情報の状態パラメーターを指定する NDIS_SWITCH_FEATURE_STATUS_PARAMETERS 構造体。 スイッチ拡張機能は、NDIS_SWITCH_FEATURE_STATUS_CUSTOM バッファーに返されるカスタム状態のバージョンを反映するために、構造体の FeatureStatusVersion メンバーを設定します。 Hyper-v 拡張可能スイッチは、クエリ OID を発行するときに他のすべてのメンバーを設定します。
  • 拡張可能スイッチの機能状態情報を含む NDIS_SWITCH_FEATURE_STATUS_CUSTOM 構造体。 スイッチ拡張機能は、返されるカスタム状態のサイズを反映するために、構造体の FeatureStatusCustomBufferLength メンバーを設定します。 Hyper-v 拡張可能スイッチは、クエリ OID を発行するときに他のすべてのメンバーを設定します。

必要条件

要件 価値
サポートされる最小クライアント NDIS 6.30 以降でサポートされています。
ヘッダー ntddndis.h (Ndis.h を含む)

関連項目

NDIS_OBJECT_HEADER

NDIS_SWITCH_FEATURE_STATUS_CUSTOM

NDIS_SWITCH_FEATURE_STATUS_TYPE

OID_SWITCH_FEATURE_STATUS_QUERY