CAC97MiniportWaveRTStream Class Reference

#include <rtstream.h>

Inheritance diagram for CAC97MiniportWaveRTStream:

Collaboration diagram for CAC97MiniportWaveRTStream:

Public Member Functions
	DECLARE_STD_UNKNOWN ()
	DEFINE_STD_CONSTRUCTOR (CAC97MiniportWaveRTStream)
	~CAC97MiniportWaveRTStream ()
NTSTATUS	Init (IN CAC97MiniportWaveRT *Miniport_, IN PPORTWAVERTSTREAM PortStream, IN ULONG Channel, IN BOOLEAN Capture, IN PKSDATAFORMAT DataFormat)
Public Member Functions inherited from CMiniportStream
	~CMiniportStream ()
void	ResetDMA (void)
void	PauseDMA (void)
void	ResumeDMA (ULONG state=DMA_ENGINE_ON)
int	GetBuffPos (DWORD *buffPos)
void	WriteReg8 (ULONG addr, UCHAR data)
void	WriteReg16 (ULONG addr, USHORT data)
void	WriteReg32 (ULONG addr, ULONG data)
UCHAR	ReadReg8 (ULONG addr)
USHORT	ReadReg16 (ULONG addr)
ULONG	ReadReg32 (ULONG addr)
	STDMETHODIMP_ (NTSTATUS) SetFormat(_In_ PKSDATAFORMAT Format)
void	PowerChangeNotify (IN POWER_STATE NewState)
virtual void	PowerChangeNotify_ (IN POWER_STATE NewState)
ULONG	GetCurrentSampleRate (void)
NTSTATUS	Init (IN CMiniport *Miniport_, IN PUNKNOWN PortStream, IN WavePins Pin_, IN BOOLEAN Capture_, IN PKSDATAFORMAT DataFormat_, OUT PSERVICEGROUP *ServiceGroup_)
virtual void	InterruptServiceRoutine () PURE
virtual NTSTATUS	Init_ () PURE
NTSTATUS	NonDelegatingQueryInterface (_In_ REFIID Interface, _COM_Outptr_ PVOID *Object, _In_ REFIID iStream, _In_ PUNKNOWN stream)
NTSTATUS	SetState (_In_ KSSTATE State)
NTSTATUS	NormalizePhysicalPosition (_Inout_ PLONGLONG PhysicalPosition)
PVOID	BDList_Alloc ()
void	BDList_Free ()
void	UpdateLviCyclic ()

Public Attributes
	IMP_IMiniportWaveRTStream
Public Attributes inherited from CUnknown
union {
IUnknown   IUnknown
INonDelegatingUnknown   INonDelegatingUnknown
};
LONG	m_ref_count
PUNKNOWN	m_outer_unknown
Public Attributes inherited from CMiniportStream
CMiniport *	Miniport
WavePins	Pin
BOOL	Capture
WORD	NumberOfChannels
DEVICE_POWER_STATE	m_PowerState
PPORTSTREAM_	PortStream
PKSDATAFORMAT_WAVEFORMATEX	DataFormat
PSERVICEGROUP	ServiceGroup
ULONG	CurrentRate
ULONG	DMAEngineState
ULONG	m_ulBDAddr
PHYSICAL_ADDRESS	BDList_PhysAddr
tBDEntry *	BDList
	IMP_IDrmAudioStream

Private Attributes
DEVICE_POWER_STATE	m_PowerState
int	mapEntries
tBDEntry *	BDList
PMDL	BDListMdl

Friends
NTSTATUS	CAC97MiniportWaveRT::InterruptServiceRoutine (IN PINTERRUPTSYNC InterruptSync, IN PVOID StaticContext)

Detailed Description

Definition at line 41 of file rtstream.h.

Constructor & Destructor Documentation

~CAC97MiniportWaveRTStream()

CAC97MiniportWaveRTStream::~CAC97MiniportWaveRTStream

(

)

Definition at line 66 of file rtstream.cpp.

{
    PAGED_CODE ();
 
 
    DOUT (DBG_PRINT, ("[CAC97MiniportWaveRTStream::~CAC97MiniportWaveRTStream]"));
 
    //
    // Delete the scatter gather list since it's not needed anymore
    //
    if (BDListMdl && BDList)
    {
        PortStream->UnmapAllocatedPages (BDList, BDListMdl);
        PortStream->FreePagesFromMdl (BDListMdl);
        BDListMdl = NULL;
        BDList = NULL;
    }
    if (BDList)
    {
        ExFreePool (BDList);
    }
 
    //
    // Release the port stream.
    //
    if (PortStream)
    {
        PortStream->Release ();
        PortStream = NULL;
    }
}

Member Function Documentation

DECLARE_STD_UNKNOWN()

CAC97MiniportWaveRTStream::DECLARE_STD_UNKNOWN

(

)

DEFINE_STD_CONSTRUCTOR()

CAC97MiniportWaveRTStream::DEFINE_STD_CONSTRUCTOR

(

CAC97MiniportWaveRTStream

)

Init()

NTSTATUS CAC97MiniportWaveRTStream::Init	(	IN CAC97MiniportWaveRT *	Miniport_,
		IN PPORTWAVERTSTREAM	PortStream,
		IN ULONG	Channel,
		IN BOOLEAN	Capture,
		IN PKSDATAFORMAT	DataFormat
	)

Definition at line 105 of file rtstream.cpp.

{
    PAGED_CODE ();
 
    DOUT (DBG_PRINT, ("[CAC97MiniportWaveRTStream::Init]"));
 
    ASSERT (Miniport_);
    ASSERT (PortStream_);
    ASSERT (DataFormat_);
 
    //
    // The rule here is that we return when we fail without a cleanup.
    // The destructor will relase the allocated memory.
    //
 
    //
    // Allocate memory for the BDL.
    // First try the least expensive way, which is to allocate it from the pool.
    // If that fails (it's outside of the controller's address range which can
    // happen on 64bit machines or PAE) then use portcls's AllocatePagesForMdl.
    //
    BDList = (tBDEntry *)ExAllocatePoolWithTag (NonPagedPool,
                        MAX_BDL_ENTRIES * sizeof (tBDEntry), PoolTag);
    if (!BDList)
    {
        DOUT (DBG_ERROR, ("Failed to allocate the BD list!"));
        return STATUS_INSUFFICIENT_RESOURCES;
    }
 
    //
    // Check to see if our HW can access it.
    // If the HW cannot see the memory, free it and use AllocatePagesForMdl
    // which allocates always complete pages, so we have to waste some memory.
    //
    if (MmGetPhysicalAddress (BDList).HighPart != 0)
    {
      PHYSICAL_ADDRESS  high;
 
      high.HighPart = 0;
      high.LowPart = MAXULONG;
      ExFreePool (BDList);
      BDListMdl = PortStream->AllocatePagesForMdl (high, PAGE_SIZE);
      if (!BDListMdl)
      {
          DOUT (DBG_ERROR, ("Failed to allocate page for BD list!"));
          return STATUS_INSUFFICIENT_RESOURCES;
      }
      BDList = (tBDEntry *)PortStream->MapAllocatedPages (BDListMdl, MmCached);
      if (!BDList)
      {
          PortStream->FreePagesFromMdl (BDListMdl);
          BDListMdl = NULL;
          DOUT (DBG_ERROR, ("Failed to map the page for the BD list!"));
          return STATUS_INSUFFICIENT_RESOURCES;
      }
    }
    
    
    return CMiniportStream::Init(Miniport_, 
                                 Channel_, 
                                 Capture_, 
                                 DataFormat_, 
                                 NULL);
}

Friends And Related Function Documentation

CAC97MiniportWaveRT::InterruptServiceRoutine

NTSTATUS CAC97MiniportWaveRT::InterruptServiceRoutine ( IN PINTERRUPTSYNC  InterruptSync, IN PVOID  StaticContext  )

friend

Member Data Documentation

BDList

tBDEntry* CAC97MiniportWaveRTStream::BDList

private

Definition at line 53 of file rtstream.h.

Referenced by Init(), STDMETHODIMP_(), and ~CAC97MiniportWaveRTStream().

BDListMdl

PMDL CAC97MiniportWaveRTStream::BDListMdl

private

Definition at line 54 of file rtstream.h.

Referenced by Init(), and ~CAC97MiniportWaveRTStream().

IMP_IMiniportWaveRTStream

CAC97MiniportWaveRTStream::IMP_IMiniportWaveRTStream

Definition at line 84 of file rtstream.h.

m_PowerState

DEVICE_POWER_STATE CAC97MiniportWaveRTStream::m_PowerState

private

Definition at line 49 of file rtstream.h.

mapEntries

int CAC97MiniportWaveRTStream::mapEntries

private

Definition at line 52 of file rtstream.h.

---

The documentation for this class was generated from the following files:

• drivers/wdm/audio/drivers/ac97/rtstream.h
• drivers/wdm/audio/drivers/ac97/rtstream.cpp