Función StreamClassRegisterAdapter (strmini.h)
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.
Requisitos
Requisito | Value |
---|---|
Plataforma de destino | Escritorio |
Encabezado | strmini.h (incluya Strmini.h) |