VDS_PORT_NOTIFICATION Struktur (vds.h)

[Ab Windows 8 und Windows Server 2012 wird die COM-Schnittstelle des Virtuellen Datenträgerdiensts durch die Windows Storage Management-API abgelöst.]

Definiert die Details von Controllerportereignissen.

Syntax

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

ulEvent

Bestimmt das Controllerportereignis, für das eine Anwendung benachrichtigt wird, als einer der folgenden Werte.

Wert	Bedeutung
VDS_NF_PORT_ARRIVE 121	Ein Controllerport wird als physisch vorhanden im Subsystem gemeldet. Der dieser Benachrichtigung zugeordnete VDS_PORT_STATUS Wert sollte ein beliebiger Wert sein, außer VDS_PRS_REMOVED.
VDS_NF_PORT_DEPART 122	Ein Controller und damit sein Port wurden physisch vom Subsystem getrennt. Der VDS_PORT_STATUS Wert sollte VDS_PRS_UNKNOWN oder VDS_PRS_REMOVED sein.
VDS_NF_PORT_MODIFY 352	Ein Member der VDS_PORT_PROP-Struktur geändert. Windows Server 2008, Windows Vista und Windows Server 2003 R2: Dieser Wert wird nicht unterstützt.
VDS_NF_PORT_REMOVED 353	Ein Controllerport ist physisch vorhanden, aber nicht für die Verwendung verfügbar. Beispielsweise ist entweder der Controller oder der Port selbst auf inaktiv festgelegt. Der VDS_PORT_STATUS Wert sollte VDS_PRS_FAILED (aufgrund eines Fehlers aus der Verwendung entfernt), VDS_PRS_OFFLINE (nicht fehlgeschlagen, aber nicht verwendet), VDS_PRS_NOT_READY oder VDS_PRS_UNKNOWN sein. Windows Server 2008, Windows Vista und Windows Server 2003 R2: Dieser Wert wird nicht unterstützt.

portId

Die VDS_OBJECT_ID des Controllerports, der das Ereignis ausgelöst hat.

Die VDS_NOTIFICATION-Struktur enthält diese Struktur als Member.

Eine Anwendung kann Datenträgerereignisse empfangen, indem sie die IVdsAdviseSink-Schnittstelle implementiert und den Schnittstellenzeiger als Argument an die IVdsService::Advise-Methode übergibt.

Verwenden Sie zum Abrufen des Portobjekts die IVdsService::GetObject-Methode . Anschließend können Sie die IVdsControllerPort::GetProperties-Methode verwenden, um die Porteigenschaften abzurufen.

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 R2 [nur Desktop-Apps]
Kopfzeile	vds.h
Verteilbare Komponente	VDS 1.1