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

Статья
02/26/2024

Метод Init инициализирует объект мини-порта топологии.

Синтаксис

NTSTATUS Init(
  [in] PUNKNOWN      UnknownAdapter,
  [in] PRESOURCELIST ResourceList,
  [in] PPORTTOPOLOGY Port
);

Параметры

[in] UnknownAdapter

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

[in] ResourceList

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

[in] Port

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

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

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

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

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