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 impulsar 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 de la rutina de DriverEnt ry del minidriver.

[in] Argument2

Apunta al segundo argumento a la rutina de driverEntry de la del minidriver.

[in] HwInitializationData

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

Valor devuelto

Devuelve STATUS_SUCCESS correcto o el código de error adecuado en caso de error.

Observaciones

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

El minidriver de la secuencia DriverEntry 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, 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, 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 del controlador necesaria, la tarea principal de una rutina DriverEntry de la clase stream 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 solicitudes SRB_GET_STREAM_INFO a la rutina de StrMiniReceiveDevicePacket del minidriver (que se pasa como el HwReceivePacket miembro de HW_INITIALIZATION_DATA).

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

Requisitos

Consulte también

HW_INITIALIZATION_DATA

SRB_GET_STREAM_INFO

SRB_INITIALIZE_DEVICE

StrMiniReceiveDevicePacket