KsAddDevice, fonction (ks.h)
La fonctionKsAddDevice est le gestionnaire de AddDevice par défaut installé par KsInitializeDriver.
Syntaxe
KSDDKAPI NTSTATUS KsAddDevice(
[in] PDRIVER_OBJECT DriverObject,
[in] PDEVICE_OBJECT PhysicalDeviceObject
);
Paramètres
[in] DriverObject
Pointeur vers l’objet pilote WDM pour le minidriver.
[in] PhysicalDeviceObject
Pointeur vers l’objet d’appareil physique WDM.
Valeur de retour
Retourne STATUS_SUCCESS indiquant que l’appareil a été correctement créé ou qu’un état d’erreur a été créé à partir de IoCreateDevice ou KsInitializeDevice.
Remarques
Normalement, un minidriver AVStream n’appelle pas cette fonction directement.
Pour plus d’informations, consultez Routine AddDevice pour les minidrivers AVStream.
KsAddDevice extrait le descripteur d’appareil stocké dans l’extension d’appareil allouée à partir d’un appel à KsInitializeDriver et crée l’appareil décrit par celui-ci. Si KsInitializeDriver n’est pas utilisé pour initialiser le pilote, cette fonction crée un appareil avec les caractéristiques par défaut et aucune fabrique de filtre. Le minidriver a toujours la possibilité d’appeler KsCreateDevice directement, auquel cas l’extension de pilote n’est pas utilisée par AVStream. Étant donné que KsAddDevice appelle KsCreateDevice, les pilotes qui appellent KsAddDevice ne doivent pas appeler KsCreateDevice séparément.
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 |