KsInitializeDevice, fonction (ks.h)
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 DEVICE_OBJECT représentant l’objet d’appareil fonctionnel WDM pour l’appareil initialisé.
Normalement, cela est retourné à partir d’un appel IoCreateDevice. Les minidrivers appelant cette fonction sont directement chargés d’appeler IoCreateDevice et de se joindre à la pile d’appareils.
[in] PhysicalDeviceObject
Pointeur vers une structure DEVICE_OBJECT représentant l’objet d’appareil physique WDM pour l’appareil initialisé.
[in] NextDeviceObject
Pointeur vers la structure de DEVICE_OBJECT suivante dans la pile d’appareils, tel qu’il est déterminé par un appel à IoAttachDeviceToDeviceStack.
[in, optional] Descriptor
Pointeur vers une structure KSDEVICE_DESCRIPTOR qui décrit les caractéristiques de l’appareil initialisé. Si ce paramètre est NULL, l’appareil est initialisé avec les caractéristiques par défaut et n’a aucune fabrique de filtre associée.
Valeur de retour
KsInitializeDevice retourne STATUS_SUCCESS si l’appareil a été initialisé avec succès. Sinon, elle retourne un code d’erreur approprié.
Remarques
La plupart des minidrivers n’appellent pas cette fonction directement. Appelez uniquement KsInitializeDevice 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum 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 | Universel |
| d’en-tête | ks.h (include Ks.h) |
| bibliothèque | Ks.lib |
| IRQL | PASSIVE_LEVEL |