KSDEVICE-Struktur (ks.h)

Artikel
02/29/2024

Die KSDEVICE-Struktur beschreibt ein funktionales WDM-Gerät, das von AVStream verwaltet wird.

Syntax

typedef struct _KSDEVICE {
  const KSDEVICE_DESCRIPTOR *Descriptor;
  KSOBJECT_BAG              Bag;
  PVOID                     Context;
  PDEVICE_OBJECT            FunctionalDeviceObject;
  PDEVICE_OBJECT            PhysicalDeviceObject;
  PDEVICE_OBJECT            NextDeviceObject;
  BOOLEAN                   Started;
  SYSTEM_POWER_STATE        SystemPowerState;
  DEVICE_POWER_STATE        DevicePowerState;
} KSDEVICE, *PKSDEVICE;

Member

Descriptor

Ein Zeiger auf eine KSDEVICE_DESCRIPTOR Struktur, die die Merkmale des Geräts und die von diesem unterstützten statischen Filter beschreibt.

Bag

Dieses Element gibt die dem Gerät zugeordnete KSOBJECT_BAG (entspricht dem Typ PVOID) an. Weitere Informationen finden Sie unter Objekttaschen.

Context

Ein Zeiger auf einen Speicherspeicherort, der Kontextinformationen für das Gerät enthält. AVStream speichert einen Zeiger auf eine Geräteerweiterung in diesem Member für Minidriver, die eine Geräteerweiterung in AVStrMiniDeviceStart zuweisen. Der für den Kontext zugewiesene Arbeitsspeicher sollte mithilfe von KsAddItemToObjectBag im Objektbehälter platziert werden. Der Kontext wird zur Erstellungszeit in NULL initialisiert.

FunctionalDeviceObject

Ein Zeiger auf eine DEVICE_OBJECT Struktur, bei der es sich um das funktionale WDM-Geräteobjekt für das beschriebene Gerät handelt.

PhysicalDeviceObject

Ein Zeiger auf eine DEVICE_OBJECT Struktur, bei der es sich um das physische WDM-Geräteobjekt für das beschriebene Gerät handelt.

NextDeviceObject

Ein Zeiger auf eine DEVICE_OBJECT Struktur, die das nächste Gerät im Treiberstapel ist, wie von IoAttachDeviceToDeviceStack bestimmt.

Started

Dieses Element gibt an, ob dieses bestimmte Gerät gestartet wurde oder nicht. Bei TRUE wurde das Gerät gestartet. Wenn FALSE, wurde das Gerät nicht gestartet. Dieses Flag wird während der Verarbeitung des IRP_MN_START_DEVICE festgelegt und während der Verarbeitung des IRP_MN_STOP_DEVICE zurückgesetzt. Ein Gerät, das nicht gestartet wurde, gibt als Antwort auf alle Anforderungen zum Erstellen eines Filters STATUS_DEVICE_NOT_READY zurück.

SystemPowerState

Ein SYSTEM_POWER_STATE typisierter Wert, der den aktuellen Energiezustand des Systems angibt. SYSTEM_POWER_STATE Werte werden in wdm.h definiert.

DevicePowerState

Ein DEVICE_POWER_STATE typisierter Wert, der den aktuellen Energiezustand des Geräts angibt. DEVICE_POWER_STATE Werte werden in wdm.h definiert.

Hinweise

Clients verwenden diese Struktur in der Regel, wenn sie ein bestimmtes PnP- oder Energieverwaltungsverhalten implementieren müssen, das nicht von AVStream bereitgestellt wird. Ein Zeiger auf eine KSDEVICE-Struktur ist der erste Parameter für alle in KSDEVICE_DISPATCH angegebenen Dispatchroutinen, und der Client kann die Kontextinformationen verwenden, um einen eigenen Kontext für diese Routinen anzufügen. Darüber hinaus können Clients einen Zeiger auf die KSDEVICE-Struktur von einem WDM-Geräteobjektzeiger abrufen, indem sie KsGetDeviceForDeviceObject aufrufen.

Wie oben erwähnt, wird der Kontext zur Erstellungszeit auf NULL initialisiert. Abkömmlinge dieser KSDEVICE-Struktur haben jedoch die entsprechenden Context-Member auf den Wert des Context-Members des übergeordneten Objekts festgelegt. Dies geschieht, wenn das neue Objekt erstellt wird. Weitere Informationen finden Sie unter AVStream-Objekthierarchie und Objekttaschen. Sehen Sie sich auch die Referenzseiten für die möglichen AVStream-Nachfolgerobjekte an: KSFILTERFACTORY, KSFILTER und KSPIN.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Microsoft Windows XP und höheren Betriebssystemen sowie in Microsoft DirectX 8.0 und höheren Versionen.
Kopfzeile	ks.h (einschließlich Ks.h)