Función StreamClassRegisterAdapter (strmini.h)

Artículo
02/26/2024

La rutina StreamClassRegisterAdapter registra un minidriver de clase de secuencia.

El nombre StreamClassRegisterAdapter solo es compatible con versiones anteriores.

En su lugar, Microsoft recomienda el uso de StreamClassRegisterMinidriver, un alias de StreamClassRegisterAdapter. El nombre StreamClassRegisterMinidriver indica con más precisión que la rutina registra un minidriver de clase de secuencia. Una vez registrado, un minidriver puede conducir cualquier número de instancias de adaptador en un sistema.

La rutina StreamClassRegisterMinidriver registra un minidriver de secuencia con el controlador de clase stream.

Sintaxis

NTSTATUS STREAMAPI StreamClassRegisterAdapter(
  [in] PVOID                   Argument1,
  [in] PVOID                   Argument2,
  [in] PHW_INITIALIZATION_DATA HwInitializationData
);

Parámetros

[in] Argument1

Apunta al primer argumento a la rutina DriverEntry del minidriver.

[in] Argument2

Apunta al segundo argumento a la rutina DriverEntry del minidriver.

[in] HwInitializationData

Apunta a una estructura de HW_INITIALIZATION_DATA que proporciona la información que el controlador de clase necesita para comenzar a inicializar el minidriver.

Valor devuelto

Devuelve STATUS_SUCCESS si se ejecuta correctamente o el código de error adecuado en caso de error.

Comentarios

Un minidriver de secuencia debe llamar a StreamClassRegisterMinidriver dentro de su rutina DriverEntry .

DriverEntry de la secuencia inicializa un minidriver de clase de secuencia. Esta rutina es necesaria.

Argument1 Proporciona un valor de contexto con el que el minidriver del adaptador debe llamar a StreamClassRegisterMinidriver. Para Windows 2000 y versiones posteriores, esto apunta a un DRIVER_OBJECT.

Argument2 Proporciona un segundo valor de contexto con el que el minidriver del adaptador debe llamar a StreamClassRegisterMinidriver. Para Windows 2000 y versiones posteriores, esto apunta a una ruta de acceso del Registro.

DriverEntry devuelve el valor devuelto por su llamada a StreamClassRegisterMinidriver.

Comentarios DriverEntry es el punto de entrada inicial de un minidriver de clase de secuencia.

Dado que StreamClassRegisterMinidriver realiza la mayor parte de la inicialización necesaria del controlador, la tarea principal de una rutina DriverEntry de una clase de secuencia es asignar y rellenar una estructura de HW_INITIALIZATION_DATA con constantes y puntos de entrada específicos del controlador. A continuación, DriverEntry debe llamar a StreamClassRegisterMinidriver.

La mayoría de la información que se pasa en la estructura de HW_INITIALIZATION_DATA informa al controlador de clase de las devoluciones de llamada de todo el minidriver y de qué tamaño se asignan los búferes de tamaño para las estructuras de datos del minidriver. El controlador de clase consulta el minidriver para obtener información adicional de inicio a través de SRB_INITIALIZE_DEVICE y SRB_GET_STREAM_INFO solicitudes a la rutina StrMiniReceiveDevicePacket del minidriver (pasada como miembro HwReceivePacket de HW_INITIALIZATION_DATA).

Una vez registrado, un minidriver puede conducir cualquier número de instancias de adaptador en un sistema.