KsInitializeDriver-Funktion (ks.h)

Artikel
02/29/2024

Die KsInitializeDriver-Funktion initialisiert das Treiberobjekt eines AVStream-Minidrivers.

Syntax

KSDDKAPI NTSTATUS KsInitializeDriver(
  [in]           PDRIVER_OBJECT            DriverObject,
  [in]           PUNICODE_STRING           RegistryPathName,
  [in, optional] const KSDEVICE_DESCRIPTOR *Descriptor
);

Parameter

[in] DriverObject

Ein Zeiger auf die DRIVER_OBJECT-Struktur für den AVStream-Treiber, der initialisiert wird. Minidriver, die KsInitializeDriver aufrufen, sollten das Treiberobjekt verwenden, das vom Betriebssystem an DriverEntry übergeben wurde.

[in] RegistryPathName

Ein Zeiger auf eine Unicode-Zeichenfolge, die die Registrierungspfadzeichenfolge enthält, die vom Betriebssystem an die DriverEntry-Funktion des Minidrivers übergeben wird.

[in, optional] Descriptor

Ein Zeiger auf eine KSDEVICE_DESCRIPTOR-Struktur , die die Merkmale des zu initialisierenden Geräts angibt. Wenn dieser Zeiger NULL ist, wird ein Gerät mit Standardmerkmalen und ohne zugeordnete Filterfabriken erstellt.

Rückgabewert

KsInitializeDriver gibt STATUS_SUCCESS oder einen entsprechenden Fehlercode zurück, der von IoCreateDevice oder internen AVStream-Geräteinitialisierungsroutinen zurückgegeben wird.

Hinweise

Diese Funktion wird in der Regel von DriverEntry aufgerufen. Wenn der Minidriver in einem Gerätedeskriptor übergeben wird, erstellt AVStream zur AddDevice-Zeit ein Gerät mit den angegebenen Merkmalen. Minidriver, die die Geräteinitialisierung selbst durchführen, müssen nicht unbedingt KsInitializeDriver aufrufen. Weitere Informationen finden Sie unter Initializing an AVStream Minidriver.

Anforderungen

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