api.cpp File Reference

#include "private.hpp"
#include <debug.h>

Include dependency graph for api.cpp:

Go to the source code of this file.

Macros
#define	NDEBUG

Functions
NTSTATUS NTAPI	PcGetDeviceProperty (IN PVOID DeviceObject, IN DEVICE_REGISTRY_PROPERTY DeviceProperty, IN ULONG BufferLength, OUT PVOID PropertyBuffer, OUT PULONG ResultLength)
ULONGLONG NTAPI	PcGetTimeInterval (IN ULONGLONG Since)
VOID NTAPI	PcIoTimerRoutine (IN PDEVICE_OBJECT DeviceObject, IN PVOID Context)
NTSTATUS NTAPI	PcRegisterIoTimeout (IN PDEVICE_OBJECT pDeviceObject, IN PIO_TIMER_ROUTINE pTimerRoutine, IN PVOID pContext)
NTSTATUS NTAPI	PcUnregisterIoTimeout (IN PDEVICE_OBJECT pDeviceObject, IN PIO_TIMER_ROUTINE pTimerRoutine, IN PVOID pContext)
NTSTATUS NTAPI	PcCompletePendingPropertyRequest (IN PPCPROPERTY_REQUEST PropertyRequest, IN NTSTATUS NtStatus)
NTSTATUS NTAPI	PcDmaMasterDescription (IN PRESOURCELIST ResourceList OPTIONAL, IN BOOLEAN ScatterGather, IN BOOLEAN Dma32BitAddresses, IN BOOLEAN IgnoreCount, IN BOOLEAN Dma64BitAddresses, IN DMA_WIDTH DmaWidth, IN DMA_SPEED DmaSpeed, IN ULONG MaximumLength, IN ULONG DmaPort, OUT PDEVICE_DESCRIPTION DeviceDescription)
NTSTATUS NTAPI	PcDmaSlaveDescription (IN PRESOURCELIST ResourceList OPTIONAL, IN ULONG DmaIndex, IN BOOLEAN DemandMode, IN BOOLEAN AutoInitialize, IN DMA_SPEED DmaSpeed, IN ULONG MaximumLength, IN ULONG DmaPort, OUT PDEVICE_DESCRIPTION DeviceDescription)

Macro Definition Documentation

NDEBUG

#define NDEBUG

Definition at line 11 of file api.cpp.

Function Documentation

PcCompletePendingPropertyRequest()

NTSTATUS NTAPI PcCompletePendingPropertyRequest	(	IN PPCPROPERTY_REQUEST	PropertyRequest,
		IN NTSTATUS	NtStatus
	)

Definition at line 181 of file api.cpp.

{
    // sanity checks
    PC_ASSERT_IRQL(DISPATCH_LEVEL);
 
    if (!PropertyRequest || !PropertyRequest->Irp || NtStatus == STATUS_PENDING)
        return STATUS_INVALID_PARAMETER;
 
    // set the final status code
    PropertyRequest->Irp->IoStatus.Status = NtStatus;
 
    // complete the irp
    IoCompleteRequest(PropertyRequest->Irp, IO_SOUND_INCREMENT);
 
    // free the property request
    FreeItem(PropertyRequest, TAG_PORTCLASS);
 
    // return success
    return STATUS_SUCCESS;
}

PcDmaMasterDescription()

NTSTATUS NTAPI PcDmaMasterDescription	(	IN PRESOURCELIST ResourceList	OPTIONAL,
		IN BOOLEAN	ScatterGather,
		IN BOOLEAN	Dma32BitAddresses,
		IN BOOLEAN	IgnoreCount,
		IN BOOLEAN	Dma64BitAddresses,
		IN DMA_WIDTH	DmaWidth,
		IN DMA_SPEED	DmaSpeed,
		IN ULONG	MaximumLength,
		IN ULONG	DmaPort,
		OUT PDEVICE_DESCRIPTION	DeviceDescription
	)

Definition at line 206 of file api.cpp.

{
 
    RtlZeroMemory(DeviceDescription, sizeof(DEVICE_DESCRIPTION));
 
    DeviceDescription->Master = TRUE;
    DeviceDescription->Version = DEVICE_DESCRIPTION_VERSION1;
    DeviceDescription->ScatterGather= ScatterGather;
    DeviceDescription->Dma32BitAddresses = Dma32BitAddresses;
    DeviceDescription->IgnoreCount = IgnoreCount;
    DeviceDescription->Dma64BitAddresses = Dma64BitAddresses;
    DeviceDescription->DmaWidth = DmaWidth;
    DeviceDescription->DmaSpeed = DmaSpeed;
    DeviceDescription->MaximumLength = MaximumLength;
    DeviceDescription->DmaPort = DmaPort;
 
    return STATUS_SUCCESS;
}

PcDmaSlaveDescription()

NTSTATUS NTAPI PcDmaSlaveDescription	(	IN PRESOURCELIST ResourceList	OPTIONAL,
		IN ULONG	DmaIndex,
		IN BOOLEAN	DemandMode,
		IN BOOLEAN	AutoInitialize,
		IN DMA_SPEED	DmaSpeed,
		IN ULONG	MaximumLength,
		IN ULONG	DmaPort,
		OUT PDEVICE_DESCRIPTION	DeviceDescription
	)

Definition at line 237 of file api.cpp.

{
 
    RtlZeroMemory(DeviceDescription, sizeof(DEVICE_DESCRIPTION));
 
    DeviceDescription->Version = DEVICE_DESCRIPTION_VERSION1;
    DeviceDescription->DemandMode = DemandMode;
    DeviceDescription->AutoInitialize = AutoInitialize;
    DeviceDescription->DmaSpeed = DmaSpeed;
    DeviceDescription->MaximumLength = MaximumLength;
    DeviceDescription->DmaPort = DmaPort;
 
    return STATUS_SUCCESS;
}

PcGetDeviceProperty()

NTSTATUS NTAPI PcGetDeviceProperty	(	IN PVOID	DeviceObject,
		IN DEVICE_REGISTRY_PROPERTY	DeviceProperty,
		IN ULONG	BufferLength,
		OUT PVOID	PropertyBuffer,
		OUT PULONG	ResultLength
	)

Definition at line 16 of file api.cpp.

{
    PPCLASS_DEVICE_EXTENSION DeviceExtension;
 
    PC_ASSERT_IRQL_EQUAL(PASSIVE_LEVEL);
 
    DeviceExtension = (PPCLASS_DEVICE_EXTENSION)((PDEVICE_OBJECT)DeviceObject)->DeviceExtension;
 
    return IoGetDeviceProperty(DeviceExtension->PhysicalDeviceObject, DeviceProperty, BufferLength, PropertyBuffer, ResultLength);
}

PcGetTimeInterval()

ULONGLONG NTAPI PcGetTimeInterval

(

IN ULONGLONG

Since

)

Definition at line 34 of file api.cpp.

{
    LARGE_INTEGER CurrentTime;
 
    KeQuerySystemTime(&CurrentTime);
 
    return (CurrentTime.QuadPart - Since);
}

Referenced by DMusMPUInterruptServiceRoutine(), InitMPU(), and WriteMPU().

PcIoTimerRoutine()

VOID NTAPI PcIoTimerRoutine	(	IN PDEVICE_OBJECT	DeviceObject,
		IN PVOID	Context
	)

Definition at line 46 of file api.cpp.

{
    PPCLASS_DEVICE_EXTENSION DeviceExtension;
    KIRQL OldIrql;
    PLIST_ENTRY ListEntry;
    PTIMER_CONTEXT CurContext;
 
    if (!DeviceObject || !DeviceObject->DeviceExtension)
        return;
 
    DeviceExtension = (PPCLASS_DEVICE_EXTENSION)DeviceObject->DeviceExtension;
 
    KeAcquireSpinLock(&DeviceExtension->TimerListLock, &OldIrql);
 
    ListEntry = DeviceExtension->TimerList.Flink;
    while(ListEntry != &DeviceExtension->TimerList)
    {
        CurContext = (PTIMER_CONTEXT)CONTAINING_RECORD(ListEntry, TIMER_CONTEXT, Entry);
 
        CurContext->pTimerRoutine(DeviceObject, CurContext->Context);
        ListEntry = ListEntry->Flink;
    }
 
    KeReleaseSpinLock(&DeviceExtension->TimerListLock, OldIrql);
}

Referenced by PcAddAdapterDevice().

PcRegisterIoTimeout()

NTSTATUS NTAPI PcRegisterIoTimeout	(	IN PDEVICE_OBJECT	pDeviceObject,
		IN PIO_TIMER_ROUTINE	pTimerRoutine,
		IN PVOID	pContext
	)

Definition at line 76 of file api.cpp.

{
    NTSTATUS Status = STATUS_SUCCESS;
    PTIMER_CONTEXT TimerContext, CurContext;
    KIRQL OldIrql;
    PLIST_ENTRY ListEntry;
    BOOLEAN bFound;
    PPCLASS_DEVICE_EXTENSION DeviceExtension;
 
    PC_ASSERT_IRQL_EQUAL(PASSIVE_LEVEL);
 
    if (!pDeviceObject || !pDeviceObject->DeviceExtension)
        return STATUS_INVALID_PARAMETER;
 
    DeviceExtension = (PPCLASS_DEVICE_EXTENSION)pDeviceObject->DeviceExtension;
 
    TimerContext = (PTIMER_CONTEXT)AllocateItem(NonPagedPool, sizeof(TIMER_CONTEXT), TAG_PORTCLASS);
    if (!TimerContext)
    {
        DPRINT("Failed to allocate memory\n");
        return STATUS_INSUFFICIENT_RESOURCES;
    }
 
    KeAcquireSpinLock(&DeviceExtension->TimerListLock, &OldIrql);
 
    ListEntry = DeviceExtension->TimerList.Flink;
    bFound = FALSE;
    while(ListEntry != &DeviceExtension->TimerList)
    {
        CurContext = (PTIMER_CONTEXT)CONTAINING_RECORD(ListEntry, TIMER_CONTEXT, Entry);
 
        if (CurContext->Context == pContext && CurContext->pTimerRoutine == pTimerRoutine)
        {
            bFound = TRUE;
            Status = STATUS_UNSUCCESSFUL;
            FreeItem(TimerContext, TAG_PORTCLASS);
            break;
        }
        ListEntry = ListEntry->Flink;
    }
 
    if (!bFound)
    {
        TimerContext->Context = pContext;
        TimerContext->pTimerRoutine = pTimerRoutine;
        InsertTailList(&DeviceExtension->TimerList, &TimerContext->Entry);
    }
 
    KeReleaseSpinLock(&DeviceExtension->TimerListLock, OldIrql);
 
    return Status;
}

PcUnregisterIoTimeout()

NTSTATUS NTAPI PcUnregisterIoTimeout	(	IN PDEVICE_OBJECT	pDeviceObject,
		IN PIO_TIMER_ROUTINE	pTimerRoutine,
		IN PVOID	pContext
	)

Definition at line 134 of file api.cpp.

{
    PTIMER_CONTEXT CurContext;
    KIRQL OldIrql;
    PLIST_ENTRY ListEntry;
    BOOLEAN bFound;
    PPCLASS_DEVICE_EXTENSION DeviceExtension;
 
    PC_ASSERT_IRQL_EQUAL(PASSIVE_LEVEL);
 
    if (!pDeviceObject || !pDeviceObject->DeviceExtension)
        return STATUS_INVALID_PARAMETER;
 
    DeviceExtension = (PPCLASS_DEVICE_EXTENSION)pDeviceObject->DeviceExtension;
 
    KeAcquireSpinLock(&DeviceExtension->TimerListLock, &OldIrql);
 
    ListEntry = DeviceExtension->TimerList.Flink;
    bFound = FALSE;
 
    while(ListEntry != &DeviceExtension->TimerList)
    {
        CurContext = (PTIMER_CONTEXT)CONTAINING_RECORD(ListEntry, TIMER_CONTEXT, Entry);
 
        if (CurContext->Context == pContext && CurContext->pTimerRoutine == pTimerRoutine)
        {
            bFound = TRUE;
            RemoveEntryList(&CurContext->Entry);
            FreeItem(CurContext, TAG_PORTCLASS);
            break;
        }
        ListEntry = ListEntry->Flink;
    }
 
    KeReleaseSpinLock(&DeviceExtension->TimerListLock, OldIrql);
 
    if (bFound)
        return STATUS_SUCCESS;
    else
        return STATUS_NOT_FOUND;
}