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

Consulte también

IPort

IMiniportWavePci::Init