KsInitializeDevice-Funktion (ks.h)

Artikel
02/29/2024

Die KsInitializeDevice-Funktion wird von AVStream aufgerufen, um die AVStream-Geräteklasse in KsCreateDevice zu initialisieren.

Syntax

KSDDKAPI NTSTATUS KsInitializeDevice(
  [in]           PDEVICE_OBJECT            FunctionalDeviceObject,
  [in]           PDEVICE_OBJECT            PhysicalDeviceObject,
  [in]           PDEVICE_OBJECT            NextDeviceObject,
  [in, optional] const KSDEVICE_DESCRIPTOR *Descriptor
);

Parameter

[in] FunctionalDeviceObject

Ein Zeiger auf eine DEVICE_OBJECT-Struktur , die das WDM-Funktionsgeräteobjekt für das zu initialisierende Gerät darstellt.

Normalerweise wird dies von einem IoCreateDevice-Aufruf zurückgegeben. Minidriver, die diese Funktion direkt aufrufen, sind für den Aufruf von IoCreateDevice und das Anfügen an den Gerätestapel verantwortlich.

[in] PhysicalDeviceObject

Ein Zeiger auf eine DEVICE_OBJECT-Struktur , die das objekt des physischen WDM-Geräts für das zu initialisierende Gerät darstellt.

[in] NextDeviceObject

Ein Zeiger auf die nächste DEVICE_OBJECT Struktur im Gerätestapel, die durch einen Aufruf von IoAttachDeviceToDeviceStack bestimmt wird.

[in, optional] Descriptor

Ein Zeiger auf eine KSDEVICE_DESCRIPTOR Struktur, die die Merkmale des zu initialisierenden Geräts beschreibt. Wenn dieser Parameter NULL ist, wird das Gerät mit den Standardmerkmalen initialisiert und verfügt über keine zugeordneten Filterfactorys.

Rückgabewert

KsInitializeDevice gibt STATUS_SUCCESS zurück, wenn das Gerät erfolgreich initialisiert wurde. Andernfalls wird ein geeigneter Fehlercode zurückgegeben.

Hinweise

Die meisten Minidriver rufen diese Funktion nicht direkt auf. Rufen Sie KsInitializeDevice nur auf, wenn Ihr Minidriver KsInitializeDriver nicht für die Initialisierung verwendet, AddDevice unabhängig behandelt und KsAddDevice oder KsCreateDevice im AddDevice-Handler nicht verwendet.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Microsoft Windows XP und höheren Betriebssystemen sowie DirectX 8.0 und höher DirectX-Versionen.
Zielplattform	Universell
Header	ks.h (ks.h einschließen)
Bibliothek	Ks.lib
IRQL	PASSIVE_LEVEL