/*

Module Name:

adapter.cpp

Abstract:

Setup and miniport installation. No resources are used by msvad.

*/

// All the GUIDS for all the miniports end up in this object.

#define PUT_GUIDS_HERE

#include "rtsdaudio.h"

#include "common.h"

//-----------------------------------------------------------------------------

// Defines

//-----------------------------------------------------------------------------

// BUGBUG set this to number of miniports

#define MAX_MINIPORTS 3 // Number of maximum miniports.

//-----------------------------------------------------------------------------

// Externals

//-----------------------------------------------------------------------------

NTSTATUS CreateMiniportWaveCyclic(

OUT PUNKNOWN *,

IN REFCLSID,

IN PUNKNOWN,

IN POOL_TYPE

);

NTSTATUS CreateMiniportTopology(

OUT PUNKNOWN *,

IN REFCLSID,

IN PUNKNOWN,

IN POOL_TYPE

);

//-----------------------------------------------------------------------------

// Referenced forward.

//-----------------------------------------------------------------------------

extern "C" NTSTATUS AddDevice(

IN PDRIVER_OBJECT,

IN PDEVICE_OBJECT

);

NTSTATUS StartDevice(

IN PDEVICE_OBJECT,

IN PIRP,

IN PRESOURCELIST

);

//-----------------------------------------------------------------------------

// Functions

//-----------------------------------------------------------------------------

#pragma code_seg("INIT")

extern "C" NTSTATUS DriverEntry(

IN PDRIVER_OBJECT DriverObject,

IN PUNICODE_STRING RegistryPathName

)

{

/*

Routine Description:

Installable driver initialization entry point.

This entry point is called directly by the I/O system.

All audio adapter drivers can use this code without change.

Arguments:

DriverObject - pointer to the driver object

RegistryPath - pointer to a unicode string representing the path,

to driver-specific key in the registry.

Return Value:

STATUS_SUCCESS if successful,

STATUS_UNSUCCESSFUL otherwise.

*/

PAGED_CODE();

NTSTATUS ntStatus;

DPF(D_TERSE, ("[DriverEntry]"));

// Tell the class driver to initialize the driver.

ntStatus = PcInitializeAdapterDriver(

DriverObject,

RegistryPathName,

AddDevice

);

return ntStatus;

} // DriverEntry

#pragma code_seg()

#pragma code_seg("PAGE")

//=============================================================================

extern "C" NTSTATUS AddDevice(

IN PDRIVER_OBJECT DriverObject,

IN PDEVICE_OBJECT PhysicalDeviceObject

)

/*

Routine Description:

The Plug & Play subsystem is handing us a brand new PDO, for which we

(by means of INF registration) have been asked to provide a driver.

We need to determine if we need to be in the driver stack for the device.

Create a function device object to attach to the stack

Initialize that device object

Return status success.

All audio adapter drivers can use this code without change.

Set MAX_MINIPORTS depending on the number of miniports that the driver

uses.

Arguments:

DriverObject - pointer to a driver object

PhysicalDeviceObject - pointer to a device object created by the

underlying bus driver.

Return Value:

NT status code.

*/

{

PAGED_CODE();

NTSTATUS ntStatus;

DPF(D_TERSE, ("[AddDevice]"));

// Tell the class driver to add the device.

ntStatus = PcAddAdapterDevice(

DriverObject,

PhysicalDeviceObject,

PCPFNSTARTDEVICE(StartDevice),

MAX_MINIPORTS,

0

);

return ntStatus;

} // AddDevice

//=============================================================================

NTSTATUS InstallSubdevice(

IN PDEVICE_OBJECT DeviceObject,

IN PIRP Irp,

IN PWCHAR Name,

IN REFGUID PortClassId,

IN REFGUID MiniportClassId,

IN PFNCREATEINSTANCE MiniportCreate OPTIONAL,

IN PUNKNOWN UnknownAdapter OPTIONAL,

IN PRESOURCELIST ResourceList,

IN REFGUID PortInterfaceId,

OUT PUNKNOWN * OutPortInterface OPTIONAL,

OUT PUNKNOWN * OutPortUnknown OPTIONAL

)

{

/*++

Routine Description:

This function creates and registers a subdevice consisting of a port

driver, a minport driver and a set of resources bound together. It will

also optionally place a pointer to an interface on the port driver in a

specified location before initializing the port driver. This is done so

that a common ISR can have access to the port driver during

initialization, when the ISR might fire.

Arguments:

DeviceObject - pointer to the driver object

Irp - pointer to the irp object.

Name - name of the miniport. Passes to PcRegisterSubDevice

PortClassId - port class id. Passed to PcNewPort.

MiniportClassId - miniport class id. Passed to PcNewMiniport.

MiniportCreate - pointer to a miniport creation function. If NULL,

PcNewMiniport is used.

UnknownAdapter - pointer to the adapter object.

Used for initializing the port.

ResourceList - pointer to the resource list.

PortInterfaceId - GUID that represents the port interface.

OutPortInterface - pointer to store the port interface

OutPortUnknown - pointer to store the unknown port interface.

Return Value:

NT status code.

--*/

PAGED_CODE();

ASSERT(DeviceObject);

ASSERT(Irp);

ASSERT(Name);

NTSTATUS ntStatus;

PPORT port = NULL;

PUNKNOWN miniport = NULL;

DPF_ENTER(("[InstallSubDevice %s]", Name));

// Create the port driver object

ntStatus = PcNewPort(&port, PortClassId);

// Create the miniport object

if (NT_SUCCESS(ntStatus)) {

if (MiniportCreate) {

ntStatus = MiniportCreate(

&miniport,

MiniportClassId,

NULL,

NonPagedPool

);

} else {

ntStatus = PcNewMiniport(

(PMINIPORT *) &miniport,

MiniportClassId

);

}

}

// Init the port driver and miniport in one go.

if (NT_SUCCESS(ntStatus)) {

ntStatus = port->Init(

DeviceObject,

Irp,

miniport,

UnknownAdapter,

ResourceList

);

if (NT_SUCCESS(ntStatus)) {

// Register the subdevice (port/miniport combination).

ntStatus = PcRegisterSubdevice(

DeviceObject,

Name,

port

);

}

// We don't need the miniport any more. Either the port has it,

// or we've failed, and it should be deleted.

miniport->Release();

}

// Deposit the port interfaces if it's needed.

if (NT_SUCCESS(ntStatus)) {

if (OutPortUnknown) {

ntStatus = port->QueryInterface(

IID_IUnknown,

(PVOID *)OutPortUnknown

);

}

if (OutPortInterface) {

ntStatus = port->QueryInterface(

PortInterfaceId,

(PVOID *) OutPortInterface

);

}

}

if (port) {

port->Release();

}

return ntStatus;

} // InstallSubDevice

//=============================================================================

NTSTATUS StartDevice

(

IN PDEVICE_OBJECT DeviceObject,

IN PIRP Irp,

IN PRESOURCELIST ResourceList

)

{

/*++

Routine Description:

This function is called by the operating system when the device is

started.

It is responsible for starting the miniports. This code is specific to

the adapter because it calls out miniports for functions that are specific

to the adapter.

Arguments:

DeviceObject - pointer to the driver object

Irp - pointer to the irp

ResourceList - pointer to the resource list assigned by PnP manager

Return Value:

NT status code.

--*/

PAGED_CODE();

ASSERT(DeviceObject);

ASSERT(Irp);

ASSERT(ResourceList);

NTSTATUS ntStatus = STATUS_SUCCESS;

PUNKNOWN unknownTopology = NULL;

PUNKNOWN unknownWave = NULL;

PADAPTERCOMMON pAdapterCommon = NULL;

PUNKNOWN pUnknownCommon = NULL;

DPF_ENTER(("[StartDevice]"));

// create a new adapter common object

ntStatus = NewAdapterCommon(

&pUnknownCommon,

IID_IAdapterCommon,

NULL,

NonPagedPool

);

if (NT_SUCCESS(ntStatus)) {

ntStatus = pUnknownCommon->QueryInterface(

IID_IAdapterCommon,

(PVOID *) &pAdapterCommon

);

if (NT_SUCCESS(ntStatus)) {

ntStatus = pAdapterCommon->Init(DeviceObject);

if (NT_SUCCESS(ntStatus)) {

// register with PortCls for power-management services

ntStatus = PcRegisterAdapterPowerManagement(

PUNKNOWN(pAdapterCommon),

DeviceObject

);

}

}

}

// install MSVAD topology miniport.

if (NT_SUCCESS(ntStatus)) {

ntStatus = InstallSubdevice(

DeviceObject,

Irp,

L"Topology",

CLSID_PortTopology,

CLSID_PortTopology,

CreateMiniportTopology,

pAdapterCommon,

NULL,

IID_IPortTopology,

NULL,

&unknownTopology

);

}

// install MSVAD wavecyclic miniport.

if (NT_SUCCESS(ntStatus)) {

ntStatus = InstallSubdevice(

DeviceObject,

Irp,

L"Wave",

CLSID_PortWaveCyclic,

CLSID_PortWaveCyclic,

CreateMiniportWaveCyclic,

pAdapterCommon,

NULL,

IID_IPortWaveCyclic,

pAdapterCommon->WavePortDriverDest(),

&unknownWave

);

}

if (unknownTopology && unknownWave)

{

// register wave <=> topology connections

// This will connect bridge pins of wavecyclic and topology

// miniports.

ntStatus = PcRegisterPhysicalConnection(

DeviceObject,

unknownTopology,

TopologyPhysicalConnections.ulTopologyOut,

unknownWave,

TopologyPhysicalConnections.ulWaveIn

);

if (NT_SUCCESS(ntStatus)) {

ntStatus = PcRegisterPhysicalConnection(

DeviceObject,

unknownWave,

TopologyPhysicalConnections.ulWaveOut,

unknownTopology,

TopologyPhysicalConnections.ulTopologyIn

);

}

}

// Release the adapter common object. It either has other references,

// or we need to delete it anyway.

if (pAdapterCommon)

pAdapterCommon->Release();

if (pUnknownCommon)

pUnknownCommon->Release();

if (unknownTopology)

unknownTopology->Release();

if (unknownWave)

unknownWave->Release();

return ntStatus;

} // StartDevice

#pragma code_seg()