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