KsInitializeDriver, fonction (ks.h)

Article
03/01/2024

La fonction KsInitializeDriver initialise l’objet pilote d’un minidriver AVStream.

Syntaxe

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

Paramètres

[in] DriverObject

Pointeur vers la structure DRIVER_OBJECT pour le pilote AVStream en cours d’initialisation. Les minidrivers qui appellent KsInitializeDriver doivent utiliser l’objet pilote transmis à DriverEntry par le système d’exploitation.

[in] RegistryPathName

Pointeur vers une chaîne Unicode contenant la chaîne de chemin d’accès du Registre transmise à la fonction DriverEntry du minidriver par le système d’exploitation.

[in, optional] Descriptor

Pointeur vers une structure de KSDEVICE_DESCRIPTOR qui spécifie les caractéristiques de l’appareil en cours d’initialisation. Si ce pointeur a la valeur NULL, un appareil est créé avec des caractéristiques par défaut et aucune fabrique de filtre associée.

Valeur retournée

KsInitializeDriver retourne STATUS_SUCCESS ou un code d’erreur approprié, tel que retourné par ioCreateDevice ou les routines d’initialisation d’appareil AVStream internes.

Remarques

Cette fonction est généralement appelée à partir de DriverEntry. Si le minidriver passe un descripteur d’appareil, AVStream crée un appareil avec les caractéristiques spécifiées à l’heure AddDevice . Les minidrivers qui effectuent eux-mêmes l’initialisation de l’appareil n’ont pas nécessairement besoin d’appeler KsInitializeDriver. Pour plus d’informations, consultez Initialisation d’un minidriver AVStream.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Microsoft Windows XP et les systèmes d’exploitation ultérieurs et DirectX 8.0 et versions ultérieures de DirectX.
Plateforme cible	Universal
En-tête	ks.h (inclure Ks.h)
Bibliothèque	Ks.lib
IRQL	PASSIVE_LEVEL