Método IMiniportWavePci::Init (portcls.h)

Artículo
02/26/2024

El Init método inicializa el objeto miniport wavePci. La inicialización incluye la comprobación del hardware mediante los recursos especificados en la lista de recursos.

Sintaxis

NTSTATUS Init(
  [in]  PUNKNOWN      UnknownAdapter,
  [in]  PRESOURCELIST ResourceList,
  [in]  PPORTWAVEPCI  Port,
  [out] PSERVICEGROUP *ServiceGroup
);

Parámetros

[in] UnknownAdapter

Puntero a la interfaz IUnknown del objeto de adaptador cuyo objeto de minipuerto se está inicializando. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

[in] ResourceList

Puntero a la interfaz IResourceList del objeto de lista de recursos que se va a proporcionar al controlador de miniporte durante la inicialización. 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. Para obtener más información, vea la sección Comentarios que se muestra más adelante.

[in] Port

Puntero al objeto de interfaz IPortWavePci del controlador de puerto. El llamador especifica un valor de puntero válido que no es NULL para este parámetro.

[out] ServiceGroup

Puntero de salida para el grupo de servicios. Este parámetro apunta a una variable de puntero asignada por el autor de la llamada en la que el método escribe un puntero a la interfaz IServiceGroup del objeto de grupo de servicios del controlador de miniport. Este es el grupo de servicios que se está registrando para la notificación de interrupción. El llamador especifica un valor de puntero válido que no es NULL para este parámetro.

Valor devuelto

Init devuelve STATUS_SUCCESS si la llamada se realizó correctamente. De lo contrario, el método devuelve un código de error adecuado.

Comentarios

Los parámetros UnknownAdapter y ResourceList son los mismos valores de puntero que el controlador de adaptador pasó anteriormente como parámetros al método Init del objeto IPortWavePci (vea IPort::Init).

Los parámetros UnknownAdapter, ResourceList, Port y ServiceGroup siguen las convenciones de recuento de referencias para objetos COM.