Fonction StreamClassRegisterAdapter (strmini.h)

Article
02/29/2024

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.