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 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 |