IMiniportWavePci::Init method (portcls.h)

Article
10/21/2021

The Init method initializes the WavePci miniport object. Initialization includes verification of the hardware using the resources specified in the resource list.

Syntax

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

Parameters

[in] UnknownAdapter

Pointer to the IUnknown interface of the adapter object whose miniport object is being initialized. For more information, see the following Remarks section.

[in] ResourceList

Pointer to IResourceList interface of resource list object that is to be supplied to the miniport driver during initialization. After passing this reference to the miniport driver, the port driver is free to examine the contents of the resource list but will not modify the contents of this list. For more information, see the following Remarks section.

[in] Port

Pointer to the port driver's IPortWavePci interface object. The caller specifies a valid, non-NULL pointer value for this parameter.

[out] ServiceGroup

Output pointer for the service group. This parameter points to a caller-allocated pointer variable into which the method writes a pointer to the IServiceGroup interface of the miniport driver's service group object. This is the service group that is being registered for interrupt notification. The caller specifies a valid, non-NULL pointer value for this parameter.

Return value

Init returns STATUS_SUCCESS if the call was successful. Otherwise, the method returns an appropriate error code.

Remarks

The UnknownAdapter and ResourceList parameters are the same pointer values that the adapter driver earlier passed as parameters to the IPortWavePci object's Init method (see IPort::Init).

The UnknownAdapter, ResourceList, Port, and ServiceGroup parameters follow the reference-counting conventions for COM objects.

Requirements

Requirement	Value
Target Platform	Universal
Header	portcls.h (include Portcls.h)
IRQL	PASSIVE_LEVEL