KsInitializeDevice, fonction (ks.h)

Article
02/26/2024

La fonction KsInitializeDevice est appelée par AVStream pour initialiser la classe d’appareil AVStream à partir de KsCreateDevice.

Syntaxe

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

Paramètres

[in] FunctionalDeviceObject

Pointeur vers une structure de DEVICE_OBJECT représentant l’objet d’appareil fonctionnel WDM pour l’appareil en cours d’initialisation.

Normalement, cela est retourné à partir d’un appel IoCreateDevice . Les minidrivers appelant cette fonction directement sont chargés d’appeler IoCreateDevice et de s’attacher à la pile des appareils.

[in] PhysicalDeviceObject

Pointeur vers une structure de DEVICE_OBJECT représentant l’objet d’appareil physique WDM pour l’appareil en cours d’initialisation.

[in] NextDeviceObject

Pointeur vers la structure de DEVICE_OBJECT suivante dans la pile d’appareils, comme déterminé par un appel à IoAttachDeviceToDeviceStack.

[in, optional] Descriptor

Pointeur vers une structure KSDEVICE_DESCRIPTOR qui décrit les caractéristiques de l’appareil en cours d’initialisation. Si ce paramètre a la valeur NULL, l’appareil est initialisé avec les caractéristiques par défaut et n’a aucune fabrique de filtre associée.

Valeur retournée

KsInitializeDevice retourne STATUS_SUCCESS si l’appareil a été correctement initialisé. Sinon, elle retourne un code d’erreur approprié.

Remarques

La plupart des minidrivers n’appellent pas cette fonction directement. Appelez KsInitializeDevice uniquement si votre minidriver n’utilise pas KsInitializeDriver pour l’initialisation, gère AddDevice indépendamment et n’utilise pas KsAddDevice ou KsCreateDevice dans son gestionnaire AddDevice .

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