dma.c File Reference

#include <videoprt.h>
#include <debug.h>

Include dependency graph for dma.c:

Go to the source code of this file.

Classes
struct	VIP_DMA_ADAPTER
struct	DMA_START_CONTEXT

Macros
#define	NDEBUG

Typedefs
typedef struct VIP_DMA_ADAPTER *	PVIP_DMA_ADAPTER
typedef struct DMA_START_CONTEXT *	PDMA_START_CONTEXT

Functions
PVOID NTAPI	VideoPortAllocateCommonBuffer (IN PVOID HwDeviceExtension, IN PVP_DMA_ADAPTER VpDmaAdapter, IN ULONG DesiredLength, OUT PPHYSICAL_ADDRESS LogicalAddress, IN BOOLEAN CacheEnabled, PVOID Reserved)
VOID NTAPI	VideoPortReleaseCommonBuffer (IN PVOID HwDeviceExtension, IN PVP_DMA_ADAPTER VpDmaAdapter, IN ULONG Length, IN PHYSICAL_ADDRESS LogicalAddress, IN PVOID VirtualAddress, IN BOOLEAN CacheEnabled)
VOID NTAPI	VideoPortPutDmaAdapter (IN PVOID HwDeviceExtension, IN PVP_DMA_ADAPTER VpDmaAdapter)
PVP_DMA_ADAPTER NTAPI	VideoPortGetDmaAdapter (IN PVOID HwDeviceExtension, IN PVP_DEVICE_DESCRIPTION VpDeviceExtension)
VOID NTAPI	VideoPortFreeCommonBuffer (IN PVOID HwDeviceExtension, IN ULONG Length, IN PVOID VirtualAddress, IN PHYSICAL_ADDRESS LogicalAddress, IN BOOLEAN CacheEnabled)
PVOID NTAPI	VideoPortGetCommonBuffer (IN PVOID HwDeviceExtension, IN ULONG DesiredLength, IN ULONG Alignment, OUT PPHYSICAL_ADDRESS LogicalAddress, OUT PULONG pActualLength, IN BOOLEAN CacheEnabled)
BOOLEAN NTAPI	VideoPortUnmapDmaMemory (PVOID HwDeviceExtension, PVOID VirtualAddress, HANDLE ProcessHandle, PDMA BoardMemoryHandle)
PDMA NTAPI	VideoPortMapDmaMemory (IN PVOID HwDeviceExtension, IN PVIDEO_REQUEST_PACKET pVrp, IN PHYSICAL_ADDRESS BoardAddress, IN PULONG Length, IN PULONG InIoSpace, IN PVOID MappedUserEvent, IN PVOID DisplayDriverEvent, IN OUT PVOID *VirtualAddress)
VOID NTAPI	VideoPortSetDmaContext (IN PVOID HwDeviceExtension, OUT PDMA pDma, IN PVOID InstanceContext)
BOOLEAN NTAPI	VideoPortSignalDmaComplete (IN PVOID HwDeviceExtension, IN PDMA pDmaHandle)
BOOLEAN NTAPI	SyncScatterRoutine (IN PVOID Context)
VOID NTAPI	ScatterAdapterControl (IN PDEVICE_OBJECT *DeviceObject, IN PIRP *Irp, IN PSCATTER_GATHER_LIST ScatterGather, IN PVOID Context)
VP_STATUS NTAPI	VideoPortStartDma (IN PVOID HwDeviceExtension, IN PVP_DMA_ADAPTER VpDmaAdapter, IN PVOID Mdl, IN ULONG Offset, IN OUT PULONG pLength, IN PEXECUTE_DMA ExecuteDmaRoutine, IN PVOID Context, IN BOOLEAN WriteToDevice)
PVOID NTAPI	VideoPortGetDmaContext (IN PVOID HwDeviceExtension, IN PDMA pDma)
PDMA NTAPI	VideoPortDoDma (IN PVOID HwDeviceExtension, IN PDMA pDma, IN DMA_FLAGS DmaFlags)
PDMA NTAPI	VideoPortAssociateEventsWithDmaHandle (IN PVOID HwDeviceExtension, IN OUT PVIDEO_REQUEST_PACKET pVrp, IN PVOID MappedUserEvent, IN PVOID DisplayDriverEvent)
VP_STATUS NTAPI	VideoPortCompleteDma (IN PVOID HwDeviceExtension, IN PVP_DMA_ADAPTER VpDmaAdapter, IN PVP_SCATTER_GATHER_LIST VpScatterGather, IN BOOLEAN WriteToDevice)

Macro Definition Documentation

NDEBUG

#define NDEBUG

Definition at line 13 of file dma.c.

Typedef Documentation

PDMA_START_CONTEXT

typedef struct DMA_START_CONTEXT * PDMA_START_CONTEXT

PVIP_DMA_ADAPTER

typedef struct VIP_DMA_ADAPTER * PVIP_DMA_ADAPTER

Function Documentation

ScatterAdapterControl()

VOID NTAPI ScatterAdapterControl	(	IN PDEVICE_OBJECT *	DeviceObject,
		IN PIRP *	Irp,
		IN PSCATTER_GATHER_LIST	ScatterGather,
		IN PVOID	Context
	)

Definition at line 336 of file dma.c.

{
    PDMA_START_CONTEXT StartContext = (PDMA_START_CONTEXT)Context;
 
    StartContext->ScatterGatherList = ScatterGather;
 
    VideoPortSynchronizeExecution(StartContext->HwDeviceExtension, VpMediumPriority, SyncScatterRoutine, StartContext);
    ExFreePool(StartContext);
}

Referenced by VideoPortStartDma().

SyncScatterRoutine()

BOOLEAN NTAPI SyncScatterRoutine

(

IN PVOID

Context

)

Definition at line 325 of file dma.c.

{
    PDMA_START_CONTEXT StartContext = (PDMA_START_CONTEXT)Context;
 
    StartContext->ExecuteDmaRoutine(StartContext->HwDeviceExtension, StartContext->VpDmaAdapter, (PVP_SCATTER_GATHER_LIST)StartContext->ScatterGatherList, StartContext->Context);
    return TRUE;
}

Referenced by ScatterAdapterControl().

VideoPortAllocateCommonBuffer()

PVOID NTAPI VideoPortAllocateCommonBuffer	(	IN PVOID	HwDeviceExtension,
		IN PVP_DMA_ADAPTER	VpDmaAdapter,
		IN ULONG	DesiredLength,
		OUT PPHYSICAL_ADDRESS	LogicalAddress,
		IN BOOLEAN	CacheEnabled,
		PVOID	Reserved
	)

Definition at line 43 of file dma.c.

{
    PVIP_DMA_ADAPTER Adapter = (PVIP_DMA_ADAPTER)VpDmaAdapter;
 
    /* check for valid arguments */
    if (!Adapter || !Adapter->Adapter)
    {
        /* invalid parameter */
        return NULL;
    }
 
    /* allocate common buffer */
    return Adapter->Adapter->DmaOperations->AllocateCommonBuffer(Adapter->Adapter, DesiredLength, LogicalAddress, CacheEnabled);
}

Referenced by VideoPortGetCommonBuffer().

VideoPortAssociateEventsWithDmaHandle()

PDMA NTAPI VideoPortAssociateEventsWithDmaHandle	(	IN PVOID	HwDeviceExtension,
		IN OUT PVIDEO_REQUEST_PACKET	pVrp,
		IN PVOID	MappedUserEvent,
		IN PVOID	DisplayDriverEvent
	)

Definition at line 439 of file dma.c.

{
    /* Deprecated */
    return NULL;
}

VideoPortCompleteDma()

VP_STATUS NTAPI VideoPortCompleteDma	(	IN PVOID	HwDeviceExtension,
		IN PVP_DMA_ADAPTER	VpDmaAdapter,
		IN PVP_SCATTER_GATHER_LIST	VpScatterGather,
		IN BOOLEAN	WriteToDevice
	)

Definition at line 453 of file dma.c.

{
    KIRQL OldIrql;
    PVIP_DMA_ADAPTER Adapter = (PVIP_DMA_ADAPTER)VpDmaAdapter;
 
    KeRaiseIrql(DISPATCH_LEVEL, &OldIrql);
    Adapter->Adapter->DmaOperations->PutScatterGatherList(Adapter->Adapter, (PSCATTER_GATHER_LIST)VpScatterGather, WriteToDevice);
    KeLowerIrql(OldIrql);
 
    return NO_ERROR;
}

VideoPortDoDma()

PDMA NTAPI VideoPortDoDma	(	IN PVOID	HwDeviceExtension,
		IN PDMA	pDma,
		IN DMA_FLAGS	DmaFlags
	)

Definition at line 426 of file dma.c.

{
    /* Deprecated */
    return NULL;
}

VideoPortFreeCommonBuffer()

VOID NTAPI VideoPortFreeCommonBuffer	(	IN PVOID	HwDeviceExtension,
		IN ULONG	Length,
		IN PVOID	VirtualAddress,
		IN PHYSICAL_ADDRESS	LogicalAddress,
		IN BOOLEAN	CacheEnabled
	)

Definition at line 187 of file dma.c.

{
    PVIP_DMA_ADAPTER VpDmaAdapter;
    PVIDEO_PORT_DEVICE_EXTENSION DeviceExtension = VIDEO_PORT_GET_DEVICE_EXTENSION(HwDeviceExtension);
 
    /* sanity check */
    ASSERT(!IsListEmpty(&DeviceExtension->DmaAdapterList));
 
    /* grab first dma adapter */
    VpDmaAdapter = (PVIP_DMA_ADAPTER)CONTAINING_RECORD(DeviceExtension->DmaAdapterList.Flink, VIP_DMA_ADAPTER, Entry);
 
    /* sanity checks */
    ASSERT(VpDmaAdapter->HwDeviceExtension == HwDeviceExtension);
    ASSERT(VpDmaAdapter->Adapter != NULL);
    ASSERT(VpDmaAdapter->MapRegisters != 0);
 
    VideoPortReleaseCommonBuffer(HwDeviceExtension, (PVP_DMA_ADAPTER)VpDmaAdapter, Length, LogicalAddress, VirtualAddress, CacheEnabled);
}

VideoPortGetCommonBuffer()

PVOID NTAPI VideoPortGetCommonBuffer	(	IN PVOID	HwDeviceExtension,
		IN ULONG	DesiredLength,
		IN ULONG	Alignment,
		OUT PPHYSICAL_ADDRESS	LogicalAddress,
		OUT PULONG	pActualLength,
		IN BOOLEAN	CacheEnabled
	)

Definition at line 215 of file dma.c.

{
    PVOID Result;
    PVIP_DMA_ADAPTER VpDmaAdapter;
    PVIDEO_PORT_DEVICE_EXTENSION DeviceExtension = VIDEO_PORT_GET_DEVICE_EXTENSION(HwDeviceExtension);
 
    /* maximum palette size */
    if (DesiredLength > 262144)
    {
        /* size exceeded */
        return NULL;
    }
 
    if (IsListEmpty(&DeviceExtension->DmaAdapterList))
    {
        /* no adapter available */
        return NULL;
    }
 
    /* grab first dma adapter */
    VpDmaAdapter = (PVIP_DMA_ADAPTER)CONTAINING_RECORD(DeviceExtension->DmaAdapterList.Flink, VIP_DMA_ADAPTER, Entry);
 
    /* sanity checks */
    ASSERT(VpDmaAdapter->HwDeviceExtension == HwDeviceExtension);
    ASSERT(VpDmaAdapter->Adapter != NULL);
    ASSERT(VpDmaAdapter->MapRegisters != 0);
 
    /* allocate common buffer */
    Result = VideoPortAllocateCommonBuffer(HwDeviceExtension, (PVP_DMA_ADAPTER)VpDmaAdapter, DesiredLength, LogicalAddress, CacheEnabled, NULL);
 
    if (Result)
    {
        /* store length */
        *pActualLength = DesiredLength;
    }
    else
    {
        /* failed to allocate common buffer */
        *pActualLength = 0;
    }
 
    return Result;
}

VideoPortGetDmaAdapter()

PVP_DMA_ADAPTER NTAPI VideoPortGetDmaAdapter	(	IN PVOID	HwDeviceExtension,
		IN PVP_DEVICE_DESCRIPTION	VpDeviceExtension
	)

Definition at line 120 of file dma.c.

{
    DEVICE_DESCRIPTION DeviceDescription;
    PVIDEO_PORT_DEVICE_EXTENSION DeviceExtension = VIDEO_PORT_GET_DEVICE_EXTENSION(HwDeviceExtension);
    ULONG NumberOfMapRegisters;
    PVIP_DMA_ADAPTER Adapter;
    PDMA_ADAPTER DmaAdapter;
 
    /* allocate private adapter structure */
    Adapter = ExAllocatePool(NonPagedPool, sizeof(VIP_DMA_ADAPTER));
    if (!Adapter)
    {
        /* failed to allocate adapter structure */
        return NULL;
    }
 
    /* Zero the structure */
    RtlZeroMemory(&DeviceDescription,
                  sizeof(DEVICE_DESCRIPTION));
 
    /* Initialize the structure */
    DeviceDescription.Version = DEVICE_DESCRIPTION_VERSION;
    DeviceDescription.Master = TRUE;
    DeviceDescription.DmaWidth = Width8Bits;
    DeviceDescription.DmaSpeed = Compatible;
 
    /* Copy data from caller's device extension */
    DeviceDescription.ScatterGather = VpDeviceExtension->ScatterGather;
    DeviceDescription.Dma32BitAddresses = VpDeviceExtension->Dma32BitAddresses;
    DeviceDescription.Dma64BitAddresses = VpDeviceExtension->Dma64BitAddresses;
    DeviceDescription.MaximumLength = VpDeviceExtension->MaximumLength;
 
    /* Copy data from the internal device extension */
    DeviceDescription.BusNumber = DeviceExtension->SystemIoBusNumber;
    DeviceDescription.InterfaceType = DeviceExtension->AdapterInterfaceType;
 
    /* acquire dma adapter */
    DmaAdapter = IoGetDmaAdapter(DeviceExtension->PhysicalDeviceObject, &DeviceDescription, &NumberOfMapRegisters);
    if (!DmaAdapter)
    {
        /* failed to acquire dma */
        ExFreePool(Adapter);
        return NULL;
    }
 
    /* store dma adapter */
    Adapter->Adapter = DmaAdapter;
 
    /* store map register count */
    Adapter->MapRegisters = NumberOfMapRegisters;
 
    /* store hw device extension */
    Adapter->HwDeviceExtension = HwDeviceExtension;
 
    /* store in dma adapter list */
    InsertTailList(&DeviceExtension->DmaAdapterList, &Adapter->Entry);
 
    /* return result */
    return (PVP_DMA_ADAPTER)Adapter;
}

VideoPortGetDmaContext()

PVOID NTAPI VideoPortGetDmaContext	(	IN PVOID	HwDeviceExtension,
		IN PDMA	pDma
	)

Definition at line 414 of file dma.c.

{
    /* Deprecated */
    return NULL;
}

VideoPortMapDmaMemory()

PDMA NTAPI VideoPortMapDmaMemory	(	IN PVOID	HwDeviceExtension,
		IN PVIDEO_REQUEST_PACKET	pVrp,
		IN PHYSICAL_ADDRESS	BoardAddress,
		IN PULONG	Length,
		IN PULONG	InIoSpace,
		IN PVOID	MappedUserEvent,
		IN PVOID	DisplayDriverEvent,
		IN OUT PVOID *	VirtualAddress
	)

Definition at line 284 of file dma.c.

{
    /* Deprecated */
    return NULL;
}

VideoPortPutDmaAdapter()

VOID NTAPI VideoPortPutDmaAdapter	(	IN PVOID	HwDeviceExtension,
		IN PVP_DMA_ADAPTER	VpDmaAdapter
	)

Definition at line 93 of file dma.c.

{
    PVIDEO_PORT_DEVICE_EXTENSION DeviceExtension;
    PVIP_DMA_ADAPTER Adapter = (PVIP_DMA_ADAPTER)VpDmaAdapter;
 
    /* get hw device extension */
    DeviceExtension = VIDEO_PORT_GET_DEVICE_EXTENSION(HwDeviceExtension);
 
    /* sanity check */
    ASSERT(!IsListEmpty(&DeviceExtension->DmaAdapterList));
 
    /* remove dma adapter from list */
    RemoveEntryList(&Adapter->Entry);
 
    /* release dma adapter */
    Adapter->Adapter->DmaOperations->PutDmaAdapter(Adapter->Adapter);
 
    /* free memory */
    ExFreePool(Adapter);
}

VideoPortReleaseCommonBuffer()

VOID NTAPI VideoPortReleaseCommonBuffer	(	IN PVOID	HwDeviceExtension,
		IN PVP_DMA_ADAPTER	VpDmaAdapter,
		IN ULONG	Length,
		IN PHYSICAL_ADDRESS	LogicalAddress,
		IN PVOID	VirtualAddress,
		IN BOOLEAN	CacheEnabled
	)

Definition at line 68 of file dma.c.

{
    PVIP_DMA_ADAPTER Adapter = (PVIP_DMA_ADAPTER)VpDmaAdapter;
 
    /* check for valid arguments */
    if (!Adapter || !Adapter->Adapter)
    {
        /* invalid parameter */
        return;
    }
 
    /* release common buffer */
    Adapter->Adapter->DmaOperations->FreeCommonBuffer(Adapter->Adapter, Length, LogicalAddress, VirtualAddress, CacheEnabled);
}

Referenced by VideoPortFreeCommonBuffer().

VideoPortSetDmaContext()

VOID NTAPI VideoPortSetDmaContext	(	IN PVOID	HwDeviceExtension,
		OUT PDMA	pDma,
		IN PVOID	InstanceContext
	)

Definition at line 302 of file dma.c.

{
    /* Deprecated */
    return;
}

VideoPortSignalDmaComplete()

BOOLEAN NTAPI VideoPortSignalDmaComplete	(	IN PVOID	HwDeviceExtension,
		IN PDMA	pDmaHandle
	)

Definition at line 315 of file dma.c.

{
    /* Deprecated */
    return FALSE;
}

VideoPortStartDma()

VP_STATUS NTAPI VideoPortStartDma	(	IN PVOID	HwDeviceExtension,
		IN PVP_DMA_ADAPTER	VpDmaAdapter,
		IN PVOID	Mdl,
		IN ULONG	Offset,
		IN OUT PULONG	pLength,
		IN PEXECUTE_DMA	ExecuteDmaRoutine,
		IN PVOID	Context,
		IN BOOLEAN	WriteToDevice
	)

Definition at line 355 of file dma.c.

{
    NTSTATUS Status;
    KIRQL OldIrql;
    PDMA_START_CONTEXT StartContext;
    PVIDEO_PORT_DEVICE_EXTENSION DeviceExtension = VIDEO_PORT_GET_DEVICE_EXTENSION(HwDeviceExtension);
    PVIP_DMA_ADAPTER Adapter = (PVIP_DMA_ADAPTER)VpDmaAdapter;
 
    StartContext = ExAllocatePool(NonPagedPool, sizeof(DMA_START_CONTEXT));
    if (!StartContext)
    {
        return ERROR_NOT_ENOUGH_MEMORY;
    }
 
    StartContext->Context = Context;
    StartContext->ExecuteDmaRoutine = ExecuteDmaRoutine;
    StartContext->HwDeviceExtension = HwDeviceExtension;
    StartContext->VpDmaAdapter = VpDmaAdapter;
 
    KeRaiseIrql(DISPATCH_LEVEL, &OldIrql);
 
    Status = Adapter->Adapter->DmaOperations->GetScatterGatherList(Adapter->Adapter,
                                                                   DeviceExtension->PhysicalDeviceObject,
                                                                   Mdl,
                                                                   MmGetSystemAddressForMdl((PMDL)Mdl),
                                                                   MmGetMdlByteCount((PMDL)Mdl),
                                                                   (PDRIVER_LIST_CONTROL)ScatterAdapterControl,
                                                                   StartContext,
                                                                   WriteToDevice);
 
    KeLowerIrql(OldIrql);
 
    if (!NT_SUCCESS(Status))
    {
        *pLength = 0;
        ExFreePool(StartContext);
        Status = ERROR_NOT_ENOUGH_MEMORY;
    }
    else
    {
        Status = NO_ERROR;
    }
 
    /* Return status */
    return Status;
}

VideoPortUnmapDmaMemory()

BOOLEAN NTAPI VideoPortUnmapDmaMemory	(	PVOID	HwDeviceExtension,
		PVOID	VirtualAddress,
		HANDLE	ProcessHandle,
		PDMA	BoardMemoryHandle
	)

Definition at line 269 of file dma.c.

{
    /* Deprecated */
    return FALSE;
}