KsInitializeDriver, fonction (ks.h)
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 du pilote AVStream initialisé. Les minidrivers qui appellent KsInitializeDriver doivent utiliser l’objet pilote passé à 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 passée dans la fonction DriverEntry du minidriver par le système d’exploitation.
[in, optional] Descriptor
Pointeur vers une structure KSDEVICE_DESCRIPTOR qui spécifie les caractéristiques de l’appareil initialisé. Si ce pointeur est NULL, un appareil est créé avec des caractéristiques par défaut et aucune fabrique de filtre associée.
Valeur de retour
KsInitializeDriver retourne STATUS_SUCCESS ou un code d’erreur approprié, tel qu’il est retourné par routines d’initialisation des appareils IOCreateDevice ou AVStream internes.
Remarques
Cette fonction est généralement appelée à partir de DriverEntry. Si le minidriver passe dans un descripteur d’appareil, AVStream crée un appareil avec les caractéristiques spécifiées à AddDevice temps. Les minidrivers qui effectuent l’initialisation de l’appareil eux-mêmes n’ont pas nécessairement besoin d’appeler KsInitializeDriver. Pour plus d’informations, consultez Initialisation d’un minidriver AVStream.
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 |