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

Artigo
03/01/2024

O Init método inicializa o objeto de miniporto WavePci. A inicialização inclui a verificação do hardware usando os recursos especificados na lista de recursos.

Sintaxe

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

Parâmetros

[in] UnknownAdapter

Ponteiro para a interface IUnknown do objeto adaptador cujo objeto miniport está sendo inicializado. Para obter mais informações, consulte a seção Comentários a seguir.

[in] ResourceList

Ponteiro para a interface IResourceList do objeto de lista de recursos que deve ser fornecido ao driver de miniporto durante a inicialização. Depois de passar essa referência para o driver de miniporto, o driver de porta fica livre para examinar o conteúdo da lista de recursos, mas não modificará o conteúdo dessa lista. Para obter mais informações, consulte a seção Comentários a seguir.

[in] Port

Ponteiro para o objeto de interface IPortWavePci do driver de porta. O chamador especifica um valor de ponteiro válido e não NULL para esse parâmetro.

[out] ServiceGroup

Ponteiro de saída para o grupo de serviços. Esse parâmetro aponta para uma variável de ponteiro alocada pelo chamador na qual o método grava um ponteiro para a interface IServiceGroup do objeto do grupo de serviços do driver de miniport. Esse é o grupo de serviços que está sendo registrado para notificação de interrupção. O chamador especifica um valor de ponteiro válido e não NULL para esse parâmetro.

Retornar valor

Init retornará STATUS_SUCCESS se a chamada tiver sido bem-sucedida. Caso contrário, o método retorna um código de erro apropriado.

Comentários

Os parâmetros UnknownAdapter e ResourceList são os mesmos valores de ponteiro que o driver do adaptador anteriormente passou como parâmetros para o método Init do objeto IPortWavePci (consulte IPort::Init).

Os parâmetros UnknownAdapter, ResourceList, Port e ServiceGroup seguem as convenções de contagem de referência para objetos COM.