Método IMiniportDMus::Init (dmusicks.h)

2025-04-09

El método Init inicializa el objeto miniport DMus.

Sintaxis

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

Parámetros

[in, optional] UnknownAdapter

Puntero al interfaz IUnknown del objeto de adaptador cuyo objeto de minipuerto se está inicializando. Este parámetro es opcional y se puede especificar como NULL. Para obtener más información, vea la siguiente sección Comentarios.

[in] ResourceList

Puntero a un objeto IResourceList que contiene la lista de recursos del adaptador. Después de pasar esta referencia al controlador de miniport, el controlador de puerto puede examinar el contenido de la lista de recursos, pero no modificará el contenido de esta lista.

[in] Port

Puntero a un objeto IPortDMus que proporciona la interfaz de devolución de llamada del controlador de puerto.

[out] ServiceGroup

Puntero de salida para el grupo de servicios. Este parámetro apunta a una variable de puntero asignada por el llamador en la que el método escribe un puntero en la interfaz IServiceGroup del objeto de grupo de servicios del controlador de miniport. Este es el grupo de servicios que este controlador de miniport quiere haber usado para las llamadas a IPortDMus::Notify.

Valor devuelto

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

Observaciones

El parámetro pUnknownAdapter es opcional:

Si pUnknownAdapter no esNULL, el método Init consulta el objeto pUnknownAdapter para su interfaz de IInterruptSync.
Si pUnknownAdapter es null, el método Init llama a PcNewInterruptSync para crear un nuevo objeto IInterruptSync. En este caso, la lista de recursos que pResourceList apunta a proporcionar el recurso de interrupción que usa el nuevo objeto IInterruptSync.

En cualquier caso, el método Init y llama al método RegisterServiceRoutine en el objeto IInterruptSync para agregar la rutina de servicio de interrupción del controlador de miniport (ISR) a la lista de ISR. Cuando el controlador del adaptador libera posteriormente el objeto port, el controlador de puerto libera su referencia al objeto IInterruptSync.

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

Los parámetros pUnknownAdapter, pResourceList, pPorty ppServiceGroup siguen las convenciones de recuento de referencias de para objetos COM.