Fonction StreamClassRegisterAdapter (strmini.h)
La routine StreamClassRegisterAdapter inscrit un minidriver de classe de flux.
Le nom StreamClassRegisterAdapter est pris en charge uniquement pour la compatibilité descendante.
Au lieu de cela, Microsoft recommande l’utilisation de StreamClassRegisterMinidriver, un alias de StreamClassRegisterAdapter. Le nom StreamClassRegisterMinidriver indique plus précisément que la routine inscrit un minidriver de classe de flux. Une fois inscrit, un minidriver peut piloter n’importe quel nombre d’instances d’adaptateur dans un système.
La routine StreamClassRegisterMinidriver inscrit un minidriver de flux avec le pilote de classe de flux.
Syntaxe
NTSTATUS STREAMAPI StreamClassRegisterAdapter(
[in] PVOID Argument1,
[in] PVOID Argument2,
[in] PHW_INITIALIZATION_DATA HwInitializationData
);
Paramètres
[in] Argument1
Pointe vers le premier argument vers la routine DriverEntry du minidriver.
[in] Argument2
Pointe vers le deuxième argument de la routine DriverEntry du minidriver.
[in] HwInitializationData
Pointe vers une structure de HW_INITIALIZATION_DATA qui fournit les informations dont le pilote de classe a besoin pour commencer à initialiser le minidriver.
Valeur retournée
Retourne STATUS_SUCCESS en cas de réussite ou le code d’erreur approprié en cas d’échec.
Remarques
Un minidriver de flux doit appeler StreamClassRegisterMinidriver dans sa routine DriverEntry .
DriverEntry du minidriver de flux initialise un minidriver de classe de flux. Cette routine est obligatoire.
Argument1 Fournit une valeur de contexte avec laquelle le minidriver de l’adaptateur doit appeler StreamClassRegisterMinidriver. Pour Windows 2000 et versions ultérieures, cela pointe vers une DRIVER_OBJECT.
Argument2 Fournit une deuxième valeur de contexte avec laquelle le minidriver de l’adaptateur doit appeler StreamClassRegisterMinidriver. Pour Windows 2000 et versions ultérieures, cela pointe vers un chemin d’accès au Registre.
DriverEntry retourne la valeur retournée par son appel à StreamClassRegisterMinidriver.
Remarques DriverEntry est le point d’entrée initial d’un minidriver de classe de flux.
Étant donné que StreamClassRegisterMinidriver effectue la majeure partie de l’initialisation de pilote requise, la tâche principale de la routine DriverEntry d’un minidriver de classe de flux consiste à allouer et à remplir une structure HW_INITIALIZATION_DATA avec des constantes et des points d’entrée spécifiques au pilote. DriverEntry doit ensuite appeler StreamClassRegisterMinidriver.
La plupart des informations transmises dans la structure de HW_INITIALIZATION_DATA informent le pilote de classe des rappels à l’échelle du minidriver et de la taille des mémoires tampons à allouer aux structures de données du minidriver. Le pilote de classe interroge le minidriver pour obtenir des informations de démarrage supplémentaires via SRB_INITIALIZE_DEVICE et SRB_GET_STREAM_INFO requêtes à la routine StrMiniReceiveDevicePacket du minidriver (passée en tant que membre HwReceivePacket de HW_INITIALIZATION_DATA).
Une fois inscrit, un minidriver peut piloter n’importe quel nombre d’instances d’adaptateur dans un système.
Configuration requise
Condition requise | Valeur |
---|---|
Plateforme cible | Desktop (Expérience utilisateur) |
En-tête | strmini.h (include Strmini.h) |