Método IPort::Init (portcls.h)
El método Init inicializa el controlador de puerto.
Sintaxis
NTSTATUS Init(
PVOID DeviceObject,
PVOID Irp,
PUNKNOWN UnknownMiniport,
PUNKNOWN UnknownAdapter,
PRESOURCELIST ResourceList
);
Parámetros
DeviceObject
Puntero al objeto de dispositivo que se pasó como argumento a la rutina de inicio del dispositivo del controlador del adaptador. El objeto device es una estructura del sistema de tipo DEVICE_OBJECT.
Irp
Puntero al IRP que se pasó como argumento a la rutina de inicio del dispositivo del controlador del adaptador.
UnknownMiniport
Puntero a la interfaz IUnknown del objeto miniport sin inicializar. Esta interfaz se consulta para la interfaz de miniport específica compatible con el controlador de puerto y se llama a la función de inicialización en esa interfaz.
UnknownAdapter
Puntero a la interfaz IUnknown del objeto de adaptador cuyo controlador de puerto se está inicializando. Este puntero es opcional y se puede especificar como NULL. Para obtener más información, vea la sección Comentarios que se muestra más adelante.
ResourceList
Puntero al objeto IResourceList que se pasó como argumento a la rutina de inicio del dispositivo del controlador del adaptador. Después de pasar esta referencia al controlador de minipuerto, el controlador de puerto es libre de examinar el contenido de la lista de recursos, pero no modificará el contenido de esta lista.
Valor devuelto
Este método devuelve NTSTATUS que contiene STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, el método devuelve un código de error adecuado.
Comentarios
El objeto miniport especificado por UnknownMiniport debe admitir la interfaz de minipuerto que requiere el controlador de puerto o se producirá un error en la llamada init.
Durante la llamada IPort::Init, el controlador de puerto llama al método de inicialización del controlador de miniport (por ejemplo, vea IMiniportWavePci::Init).
El parámetro UnknownAdapter apunta a la interfaz COM de un objeto de adaptador. El controlador del adaptador normalmente crea este objeto dentro de su rutina de inicio del dispositivo, que es la rutina a la que llama el sistema operativo para iniciar el dispositivo (consulte Secuencia de inicio). Para obtener un ejemplo de una interfaz para un objeto de adaptador, consulte la definición y la CMiniportWaveRT::Init implementación en el ejemplo de controlador de audio sysvad.
Los parámetros UnknownMiniport, UnknownAdapter y ResourceList siguen las convenciones estándar de recuento de referencias para objetos COM.
Requisitos
| Requisito | Valor |
|---|---|
| Header | portcls.h |
| IRQL | PASSIVE_LEVEL |