Función ChangerClassInitialize (mcd.h)
La rutina ChangerClassInitialize inicializa el controlador.
Sintaxis
NTSTATUS ChangerClassInitialize(
[in] PDRIVER_OBJECT DriverObject,
[in] PUNICODE_STRING RegistryPath,
PMCD_INIT_DATA ChangerInitData
);
Parámetros
[in] DriverObject
Puntero al objeto de controlador de miniclase modificador. Esto se pasa como parámetro a la rutina DriverEntry del controlador de miniclase. El formato de este objeto es específico del sistema operativo y el controlador de miniclase no debe interpretarlo.
[in] RegistryPath
Puntero a la ruta de acceso del Registro para el controlador de miniclase del modificador. Esto también se pasa como parámetro a la rutina DriverEntry del controlador de miniclase. El formato de este es específico del sistema operativo y el controlador de miniclase no debe interpretarlo.
ChangerInitData
Puntero a una estructura de MCD_INIT_DATA que contiene información específica del controlador de miniclase, como los puntos de entrada para las rutinas de procesamiento de comandos del controlador de miniclase modificador.
Valor devuelto
ChangerClassInitialize devuelve un valor que indica el éxito o error de la inicialización del controlador. Si la inicialización se realiza correctamente, ChangerClassInitialize devuelve STATUS_SUCCESS. De lo contrario, ChangerClassInitialize devuelve un mensaje de error adecuado. Los minidrivers no deben interpretar este valor de error, pero solo deben devolver este valor de su rutina DriverEntry .
Comentarios
ChangerClassInitialize es una rutina de controlador de clase de modificador que los controladores de miniclase pueden llamar en Microsoft Windows XP y sistemas operativos posteriores.
Los controladores de miniclase de ChangerClassInitialize llaman a ChangerClassInitialize desde sus rutinas driverEntry para inicializar el controlador. ChangerClassInitialize realiza muchas tareas realizadas anteriormente por la rutina DriverEntry del controlador de clase changer, como registrar las rutinas de distribución del controlador de miniclase. Asigna una extensión de objeto de controlador y copia los datos contenidos en MCDInitData en la extensión de objeto del controlador junto con otros datos de inicialización, como la ruta de acceso del registro del controlador y los punteros a determinadas rutinas de controlador de clase de modificador que son específicas del sistema operativo.
Los controladores de miniclase del modificador deben asignar una estructura de MCD_INIT_DATA , cero la estructura llamando a RtlZeroMemory y, a continuación, asignar valores a los miembros adecuados, antes de pasar la dirección de la estructura a ChangerClassInitialize mediante el parámetro MCDInitData .
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | mcd.h (incluya Mcd.h, Ntddchgr.h) |
| Library | Mcd.lib |