Метод IMiniportWavePci::Init (portcls.h)

Статья
03/01/2024

Метод Init инициализирует объект miniport WavePci. Инициализация включает проверку оборудования с использованием ресурсов, указанных в списке ресурсов.

Синтаксис

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

Параметры

[in] UnknownAdapter

Указатель на интерфейс IUnknown объекта адаптера, для которого выполняется инициализация объекта miniport. Дополнительные сведения см. в разделе "Примечания".

[in] ResourceList

Указатель на интерфейс IResourceList объекта списка ресурсов, который должен быть предоставлен драйверу miniport во время инициализации. После передачи этой ссылки драйверу мини-порта драйвер порта может изучить содержимое списка ресурсов, но не будет изменять содержимое этого списка. Дополнительные сведения см. в разделе "Примечания".

[in] Port

Указатель на объект интерфейса IPortWavePci драйвера порта. Вызывающий объект задает допустимое значение указателя, отличное от NULL, для этого параметра.

[out] ServiceGroup

Указатель вывода для группы служб. Этот параметр указывает на выделенную вызывающим объектом переменную указателя, в которую метод записывает указатель на интерфейс IServiceGroup объекта группы служб драйвера мини-порта. Это группа служб, которая регистрируется для уведомления о прерывании. Вызывающий объект задает допустимое значение указателя, отличное от NULL, для этого параметра.

Возвращаемое значение

Init возвращает STATUS_SUCCESS, если вызов был успешным. В противном случае метод возвращает соответствующий код ошибки.

Параметры UnknownAdapter и ResourceList — это те же значения указателя, которые драйвер адаптера ранее передал в качестве параметров методу Init объекта IPortWavePci (см. раздел IPort::Init).

Параметры UnknownAdapter, ResourceList, Port и ServiceGroup следуют соглашениям о подсчете ссылок для COM-объектов.