StreamClassRegisterAdapter, fonction (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, 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 conduire n’importe quel nombre d’instances d’adaptateur dans un système.

Le StreamClassRegisterMinidriver routine inscrit un minidriver de flux auprès du 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 de 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 HW_INITIALIZATION_DATA qui fournit les informations dont le pilote de classe a besoin pour commencer à initialiser le minidriver.

Valeur de retour

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.

Le minidriver de flux DriverEntry initialise un minidriver de classe de flux. Cette routine est requise.

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 plupart des initialisations de pilotes requises, la tâche principale d’une routine PiloteEntry d’une 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 HW_INITIALIZATION_DATA informent le pilote de classe des rappels à l’échelle du minidriver, ainsi que les mémoires tampons de taille à allouer pour les 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 demandes adressées à la routine StrMiniReceiveDevicePacket (transmise en tant que HwReceivePacket membre de HW_INITIALIZATION_DATA).

Une fois inscrit, un minidriver peut conduire n’importe quel nombre d’instances d’adaptateur dans un système.

Exigences

Voir aussi

HW_INITIALIZATION_DATA

SRB_GET_STREAM_INFO

SRB_INITIALIZE_DEVICE

StrMiniReceiveDevicePacket