VDS_PORT_NOTIFICATION 構造体 (vds.h)

[Windows 8とWindows Server 2012以降、Virtual Disk Service COM インターフェイスは Windows Storage Management API に置き換えられます。

コントローラーポートイベントの詳細を定義します。

構文

typedef struct _VDS_PORT_NOTIFICATION {
  ULONG         ulEvent;
  VDS_OBJECT_ID portId;
} VDS_PORT_NOTIFICATION;

ulEvent

アプリケーションに通知されるコントローラーポートイベントを、次のいずれかの値として決定します。

値	意味
VDS_NF_PORT_ARRIVE 121	コントローラーポートは、サブシステムに物理的に存在すると報告されます。この通知に関連付けられている VDS_PORT_STATUS 値は、VDS_PRS_REMOVEDを除く任意の値である必要があります。
VDS_NF_PORT_DEPART 122	コントローラーとそのポートは、サブシステムから物理的に取り外されました。 VDS_PORT_STATUS値は、VDS_PRS_UNKNOWNまたはVDS_PRS_REMOVEDする必要があります。
VDS_NF_PORT_MODIFY 352	VDS_PORT_PROP 構造体のメンバーが変更されました。 Windows Server 2008、Windows Vista、Windows Server 2003 R2: この値はサポートされていません。
VDS_NF_PORT_REMOVED 353	コントローラーポートは物理的に存在しますが、使用できません。たとえば、コントローラーまたはポート自体が非アクティブに設定されています。 VDS_PORT_STATUSの値は、VDS_PRS_FAILED (失敗のため使用から削除)、VDS_PRS_OFFLINE (失敗したわけではありませんが、どちらも使用されていません)、VDS_PRS_NOT_READY、またはVDS_PRS_UNKNOWNする必要があります。 Windows Server 2008、Windows Vista、Windows Server 2003 R2: この値はサポートされていません。

portId

イベントをトリガーしたコントローラーポートの VDS_OBJECT_ID 。

VDS_NOTIFICATION構造体には、この構造体がメンバーとして含まれます。

アプリケーションは、 IVdsAdviseSink インターフェイスを実装し、インターフェイスポインターを IVdsService::Advise メソッドの引数として渡すことで、ディスクイベントを受信できます。

ポートオブジェクトを取得するには、 IVdsService::GetObject メソッドを使用します。その後、 IVdsControllerPort::GetProperties メソッドを使用して、ポートのプロパティを取得できます。

要件	値
サポートされている最小のクライアント	Windows Vista [デスクトップアプリのみ]
サポートされている最小のサーバー	Windows Server 2003 R2 [デスクトップアプリのみ]
Header	vds.h
再頒布可能パッケージ	VDS 1.1