fxdmatransactionapi.cpp File Reference

#include "fxdmapch.hpp"

Include dependency graph for fxdmatransactionapi.cpp:

Go to the source code of this file.

Functions
_Must_inspect_result_	__drv_maxIRQL (DISPATCH_LEVEL) NTSTATUS WDFEXPORT(WdfDmaTransactionCreate)(__in PWDF_DRIVER_GLOBALS DriverGlobals
	FxObjectHandleGetPtrAndGlobals (GetFxDriverGlobals(DriverGlobals), DmaEnabler, FX_TYPE_DMA_ENABLER,(PVOID *) &pDmaEnabler, &pFxDriverGlobals)
	FxPointerNotNull (pFxDriverGlobals, DmaTransactionHandle)
	if (!NT_SUCCESS(status))
	switch (pDmaEnabler->GetProfile())
	FxObjectHandleGetPtrAndGlobals (GetFxDriverGlobals(DriverGlobals), DmaTransaction, FX_TYPE_DMA_TRANSACTION,(PVOID *) &pDmaTrans, &pFxDriverGlobals)
	FxPointerNotNull (pFxDriverGlobals, EvtProgramDmaFunction)
	if (DmaDirection !=WdfDmaDirectionReadFromDevice &&DmaDirection !=WdfDmaDirectionWriteToDevice)
	FxObjectHandleGetPtr (pFxDriverGlobals, Request, FX_TYPE_REQUEST,(PVOID *) &pReqObj)
	switch (stack->MajorFunction)
	if (reqLength==0)
	if (pDmaTrans->GetDmaEnabler() ->SupportsChainedMdls()==FALSE)
pDmaTrans	SetRequest (pReqObj)
_Must_inspect_result_ __in WDFDMATRANSACTION __in PFN_WDF_PROGRAM_DMA __in WDF_DMA_DIRECTION __in PMDL __in size_t __in	__drv_when (Length==0, __drv_reportError(Length cannot be zero)) size_t Length)
	FxObjectHandleGetPtr (GetFxDriverGlobals(DriverGlobals), DmaTransaction, FX_TYPE_DMA_TRANSACTION,(PVOID *) &pDmaTrans)
return pDmaTrans	Execute (Context)
	__success (TRUE) __drv_maxIRQL(DISPATCH_LEVEL) NTSTATUS WDFEXPORT(WdfDmaTransactionRelease)(__in PWDF_DRIVER_GLOBALS DriverGlobals
pDmaTrans	ReleaseForReuse (FALSE)
	FxPointerNotNull (pDmaTrans->GetDriverGlobals(), pStatus)
return pDmaTrans	DmaCompleted (0, pStatus, FxDmaCompletionTypeFull)
return pDmaTrans	DmaCompleted (TransferredLength, pStatus, FxDmaCompletionTypePartial)
return pDmaTrans	DmaCompleted (FinalTransferredLength, pStatus, FxDmaCompletionTypeAbort)
return pDmaTrans	GetBytesTransferred ()
pDmaTrans	SetMaximumFragmentLength (MaximumLength)
	if (pRequest !=NULL)
return pDmaTrans	GetCurrentFragmentLength ()
return pDmaTrans	GetDmaEnabler () -> GetDeviceHandle()
	if ((profile !=WdfDmaProfileSystem) &&(profile !=WdfDmaProfileSystemDuplex))
systemTransaction	SetConfigureChannelCallback (ConfigureRoutine, ConfigureContext)
systemTransaction	SetTransferCompleteCallback (DmaCompletionRoutine, DmaCompletionContext)
systemTransaction	SetDeviceAddressOffset (Offset)
	if (pDmaTrans->GetDmaEnabler() ->UsesDmaV3()==FALSE)
	if ((state==FxDmaTransactionStateInvalid)||(state==FxDmaTransactionStateCreated)||(state==FxDmaTransactionStateReleased)||(state==FxDmaTransactionStateDeleted))
return pDmaTrans	GetTransferContext ()
pDmaTrans	GetTransferInfo (MapRegisterCount, ScatterGatherElementCount)
pDmaTrans	SetImmediateExecution (UseImmediateExecution)
	if ((profile !=WdfDmaProfilePacket) &&(profile !=WdfDmaProfilePacket64) &&(profile !=WdfDmaProfileSystem) &&(profile !=WdfDmaProfileSystemDuplex))
	FxPointerNotNull (pFxDriverGlobals, EvtReserveDmaFunction)
pDmaTrans	ReleaseAdapter ()
return pDmaTrans	CancelResourceAllocation ()
systemTransaction	StopTransfer ()

Variables
_Must_inspect_result_ __in WDFDMAENABLER	DmaEnabler
_Must_inspect_result_ __in WDFDMAENABLER __in_opt WDF_OBJECT_ATTRIBUTES *	Attributes
_Must_inspect_result_ __in WDFDMAENABLER __in_opt WDF_OBJECT_ATTRIBUTES __out WDFDMATRANSACTION *	DmaTransactionHandle
FxDmaEnabler *	pDmaEnabler
PFX_DRIVER_GLOBALS	pFxDriverGlobals
	status
_Must_inspect_result_ __in WDFDMATRANSACTION	DmaTransaction
_Must_inspect_result_ __in WDFDMATRANSACTION __in WDFREQUEST	Request
_Must_inspect_result_ __in WDFDMATRANSACTION __in WDFREQUEST __in PFN_WDF_PROGRAM_DMA	EvtProgramDmaFunction
_Must_inspect_result_ __in WDFDMATRANSACTION __in WDFREQUEST __in PFN_WDF_PROGRAM_DMA __in WDF_DMA_DIRECTION	DmaDirection
FxDmaTransactionBase *	pDmaTrans
FxRequest *	pReqObj
MDL *	mdl = NULL
PIO_STACK_LOCATION	stack = pReqObj->GetFxIrp()->GetCurrentIrpStackLocation()
ULONG	reqLength = 0
return	STATUS_SUCCESS
_Must_inspect_result_ __in WDFDMATRANSACTION __in PFN_WDF_PROGRAM_DMA __in WDF_DMA_DIRECTION __in PMDL	Mdl
_Must_inspect_result_ __in WDFDMATRANSACTION __in PFN_WDF_PROGRAM_DMA __in WDF_DMA_DIRECTION __in PMDL __in size_t	Offset
_Must_inspect_result_ __in WDFDMATRANSACTION __in PFN_WDF_PROGRAM_DMA __in WDF_DMA_DIRECTION __in PMDL __in PVOID	VirtualAddress
_Must_inspect_result_ __in WDFDMATRANSACTION __in_opt WDFCONTEXT	Context
__in WDFDMATRANSACTION __out NTSTATUS *	pStatus
__in WDFDMATRANSACTION __in size_t	TransferredLength
__in WDFDMATRANSACTION __in size_t	FinalTransferredLength
__in WDFDMATRANSACTION __in size_t	MaximumLength
FxRequest *	pRequest = pDmaTrans->GetRequest()
	else
__in WDFDMATRANSACTION __in_opt PFN_WDF_DMA_TRANSACTION_CONFIGURE_DMA_CHANNEL	ConfigureRoutine
__in WDFDMATRANSACTION __in_opt PFN_WDF_DMA_TRANSACTION_CONFIGURE_DMA_CHANNEL __in_opt PVOID	ConfigureContext
WDF_DMA_PROFILE	profile = pDmaTrans->GetDmaEnabler()->GetProfile()
FxDmaSystemTransaction *	systemTransaction = (FxDmaSystemTransaction*) pDmaTrans
__in WDFDMATRANSACTION __in_opt PFN_WDF_DMA_TRANSACTION_DMA_TRANSFER_COMPLETE	DmaCompletionRoutine
__in WDFDMATRANSACTION __in_opt PFN_WDF_DMA_TRANSACTION_DMA_TRANSFER_COMPLETE __in_opt PVOID	DmaCompletionContext
FxDmaTransactionState	state = pDmaTrans->GetTransactionState()
__in WDFDMATRANSACTION __out_opt ULONG *	MapRegisterCount
__in WDFDMATRANSACTION __out_opt ULONG __out_opt ULONG *	ScatterGatherElementCount
__in WDFDMATRANSACTION __in BOOLEAN	UseImmediateExecution
__in WDFDMATRANSACTION __in WDF_DMA_DIRECTION __in ULONG	RequiredMapRegisters
__in WDFDMATRANSACTION __in WDF_DMA_DIRECTION __in ULONG __in PFN_WDF_RESERVE_DMA	EvtReserveDmaFunction
__in WDFDMATRANSACTION __in WDF_DMA_DIRECTION __in ULONG __in PFN_WDF_RESERVE_DMA __in PVOID	EvtReserveDmaContext
	return

Function Documentation

__drv_maxIRQL()

_Must_inspect_result_ __drv_maxIRQL

(

DISPATCH_LEVEL

)

__drv_when()

_Must_inspect_result_ __in WDFDMATRANSACTION __in PFN_WDF_PROGRAM_DMA __in WDF_DMA_DIRECTION __in PMDL __in size_t __in __drv_when	(	Length	= = 0,
		__drv_reportError(Length cannot be zero)
	)

Definition at line 377 of file fxdmatransactionapi.cpp.

{
    //
    // Stub this out by calling the regular initialize method.  Eventually
    // the regular initialize method will call this instead.
    //
 
    return WDFEXPORT(WdfDmaTransactionInitialize)(
            DriverGlobals,
            DmaTransaction,
            EvtProgramDmaFunction,
            DmaDirection,
            Mdl,
            (PVOID) (((ULONG_PTR) MmGetMdlVirtualAddress(Mdl)) + Offset),
            Length
            );
}

__success()

__success

(

TRUE

)

CancelResourceAllocation()

return pDmaTrans CancelResourceAllocation

(

)

DmaCompleted() [1/3]

return pDmaTrans DmaCompleted	(	0	,
		pStatus	,
		FxDmaCompletionTypeFull
	)

DmaCompleted() [2/3]

return pDmaTrans DmaCompleted	(	FinalTransferredLength	,
		pStatus	,
		FxDmaCompletionTypeAbort
	)

DmaCompleted() [3/3]

return pDmaTrans DmaCompleted	(	TransferredLength	,
		pStatus	,
		FxDmaCompletionTypePartial
	)

Execute()

return pDmaTrans Execute

(

Context

)

FxObjectHandleGetPtr() [1/2]

FxObjectHandleGetPtr	(	GetFxDriverGlobals(DriverGlobals)	,
		DmaTransaction	,
		FX_TYPE_DMA_TRANSACTION	,
		(PVOID *) &	pDmaTrans
	)

FxObjectHandleGetPtr() [2/2]

FxObjectHandleGetPtr	(	pFxDriverGlobals	,
		Request	,
		FX_TYPE_REQUEST	,
		(PVOID *) &	pReqObj
	)

Referenced by __success().

FxObjectHandleGetPtrAndGlobals() [1/2]

FxObjectHandleGetPtrAndGlobals	(	GetFxDriverGlobals(DriverGlobals)	,
		DmaEnabler	,
		FX_TYPE_DMA_ENABLER	,
		(PVOID *) &	pDmaEnabler,
		&	pFxDriverGlobals
	)

FxObjectHandleGetPtrAndGlobals() [2/2]

FxObjectHandleGetPtrAndGlobals	(	GetFxDriverGlobals(DriverGlobals)	,
		DmaTransaction	,
		FX_TYPE_DMA_TRANSACTION	,
		(PVOID *) &	pDmaTrans,
		&	pFxDriverGlobals
	)

FxPointerNotNull() [1/4]

FxPointerNotNull	(	pDmaTrans->	GetDriverGlobals(),
		pStatus
	)

FxPointerNotNull() [2/4]

FxPointerNotNull	(	pFxDriverGlobals	,
		DmaTransactionHandle
	)

FxPointerNotNull() [3/4]

FxPointerNotNull	(	pFxDriverGlobals	,
		EvtProgramDmaFunction
	)

FxPointerNotNull() [4/4]

FxPointerNotNull	(	pFxDriverGlobals	,
		EvtReserveDmaFunction
	)

GetBytesTransferred()

return pDmaTrans GetBytesTransferred

(

)

GetCurrentFragmentLength()

return pDmaTrans GetCurrentFragmentLength

(

)

GetDmaEnabler()

return pDmaTrans GetDmaEnabler

(

)

-> GetDeviceHandle()

Referenced by FxDmaPacketTransaction::StageTransfer().

GetTransferContext()

return pDmaTrans GetTransferContext

(

)

Referenced by FxDmaPacketTransaction::AllocateAdapterChannel(), FxDmaScatterGatherTransaction::BuildScatterGatherList(), FxDmaSystemTransaction::CancelMappedTransfer(), FxDmaTransactionBase::CancelResourceAllocation(), FxDmaScatterGatherTransaction::GetScatterGatherList(), FxDmaTransactionBase::Initialize(), and FxDmaPacketTransaction::ReserveAdapter().

GetTransferInfo()

pDmaTrans GetTransferInfo	(	MapRegisterCount	,
		ScatterGatherElementCount
	)

if() [1/9]

if

(

!

NT_SUCCESSstatus

)

Definition at line 67 of file fxdmatransactionapi.cpp.

                             {
        return status;
    }

if() [2/9]

if

(

(profile !=WdfDmaProfilePacket) &&(profile !=WdfDmaProfilePacket64) &&(profile !=WdfDmaProfileSystem) &&(profile !=WdfDmaProfileSystemDuplex)

)

Definition at line 1072 of file fxdmatransactionapi.cpp.

                                                {
 
        status = STATUS_INVALID_DEVICE_REQUEST;
 
        DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDMA,
                            "Cannot call %!FUNC! on non packet or system "
                            "profile WDFDMATRANSACTION (%p) (transaction "
                            "profile is %!WDF_DMA_PROFILE!) - %!STATUS!.",
                            DmaTransaction,
                            profile,
                            status);
        FxVerifierDbgBreakPoint(pFxDriverGlobals);
        return status;
    }

if() [3/9]

if

(

(profile !=WdfDmaProfileSystem) &&(profile !=WdfDmaProfileSystemDuplex)

)

Definition at line 790 of file fxdmatransactionapi.cpp.

                                                {
        DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDMA,
                            "Cannot call %!FUNC! on non-system-profile "
                            "WDFDMATRANSACTION (%p) (transaction profile "
                            "is %!WDF_DMA_PROFILE!).",
                            DmaTransaction,
                            profile);
        FxVerifierDbgBreakPoint(pFxDriverGlobals);
        return;
    }

if() [4/9]

if

(

(state==FxDmaTransactionStateInvalid)||(state==FxDmaTransactionStateCreated)||(state==FxDmaTransactionStateReleased)||(state==FxDmaTransactionStateDeleted)

)

Definition at line 939 of file fxdmatransactionapi.cpp.

                                                 {
        DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDMA,
                            "Cannot call %!FUNC! on WDFDMATRANSACTION %p "
                            "becuase it is uninitialized, reused, deleted "
                            "(state is %!FxDmaTransactionState!).",
                            DmaTransaction,
                            state
                            );
        FxVerifierDbgBreakPoint(pFxDriverGlobals);
        return NULL;
    }

if() [5/9]

if

(

DmaDirection !

= WdfDmaDirectionReadFromDevice && DmaDirection != WdfDmaDirectionWriteToDevice

)

Definition at line 142 of file fxdmatransactionapi.cpp.

                                                      {
        status = STATUS_INVALID_PARAMETER;
        DoTraceLevelMessage(
            pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDMA,
            "Initialization of WDFDMATRANSACTION 0x%p using WDFREQUEST %p, "
            "DmaDirection 0x%x is an invalid value, %!STATUS!",
            DmaTransaction, Request, DmaDirection, status);
        return status;
    }

if() [6/9]

if

(

pDmaTrans->

GetDmaEnabler) ->SupportsChainedMdls( = = FALSE

)

Definition at line 317 of file fxdmatransactionapi.cpp.

                                                                    {
        ULONG  length;
 
        length = MmGetMdlByteCount(mdl);
 
        if (reqLength > length) {
            status = STATUS_INVALID_PARAMETER;
            DoTraceLevelMessage(
                pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDMA,
                "WDFREQUEST %p transfer length (%d) is out of bounds of MDL "
                "Byte count (%d), %!STATUS!",
                Request, reqLength, length, status);
 
            return status;
        }
    }

if() [7/9]

if

(

pDmaTrans->

GetDmaEnabler) ->UsesDmaV3( = = FALSE

)

Definition at line 926 of file fxdmatransactionapi.cpp.

                                                          {
        DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDMA,
                            "Cannot call %!FUNC! for WDFDMATRANSACTION %p "
                            "because the parent WDFDMAENABLER (%p) is not "
                            "configured to use DMA version 3.",
                            DmaTransaction,
                            pDmaTrans->GetDmaEnabler()->GetHandle());
        FxVerifierDbgBreakPoint(pFxDriverGlobals);
        return NULL;
    }

if() [8/9]

if

(

pRequest !

= NULL

)

Definition at line 716 of file fxdmatransactionapi.cpp.

                          {
        return pRequest->GetHandle();
    }

if() [9/9]

if

(

reqLength

= = 0

)

Definition at line 303 of file fxdmatransactionapi.cpp.

                        {
        status = STATUS_INVALID_DEVICE_REQUEST;
        DoTraceLevelMessage(
            pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDMA,
            "Zero length request, %!STATUS!", status);
        return status;
    }

ReleaseAdapter()

pDmaTrans ReleaseAdapter

(

)

ReleaseForReuse()

pDmaTrans ReleaseForReuse

(

FALSE

)

SetConfigureChannelCallback()

systemTransaction SetConfigureChannelCallback	(	ConfigureRoutine	,
		ConfigureContext
	)

SetDeviceAddressOffset()

systemTransaction SetDeviceAddressOffset

(

Offset

)

SetImmediateExecution()

pDmaTrans SetImmediateExecution

(

UseImmediateExecution

)

SetMaximumFragmentLength()

pDmaTrans SetMaximumFragmentLength

(

MaximumLength

)

SetRequest()

pDmaTrans SetRequest

(

pReqObj

)

SetTransferCompleteCallback()

systemTransaction SetTransferCompleteCallback	(	DmaCompletionRoutine	,
		DmaCompletionContext
	)

StopTransfer()

systemTransaction StopTransfer

(

)

switch() [1/2]

switch

(

pDmaEnabler->

GetProfile()

)

Definition at line 71 of file fxdmatransactionapi.cpp.

    {
        case WdfDmaProfilePacket:
        case WdfDmaProfilePacket64:
            status = FxDmaPacketTransaction::_Create(pFxDriverGlobals,
                                                     Attributes,
                                                     pDmaEnabler,
                                                     DmaTransactionHandle);
            break;
 
        case WdfDmaProfileScatterGather:
        case WdfDmaProfileScatterGather64:
        case WdfDmaProfileScatterGatherDuplex:
        case WdfDmaProfileScatterGather64Duplex:
            status = FxDmaScatterGatherTransaction::_Create(
                                                        pFxDriverGlobals,
                                                        Attributes,
                                                        pDmaEnabler,
                                                        DmaTransactionHandle
                                                        );
            break;
 
        case WdfDmaProfileSystem:
        case WdfDmaProfileSystemDuplex:
            status = FxDmaSystemTransaction::_Create(pFxDriverGlobals,
                                                     Attributes,
                                                     pDmaEnabler,
                                                     DmaTransactionHandle);
            break;
 
        default:
            NT_ASSERTMSG("Unknown profile for DMA enabler", FALSE);
            status = STATUS_UNSUCCESSFUL;
            break;
    }

switch() [2/2]

switch

(

stack->

MajorFunction

)

Definition at line 165 of file fxdmatransactionapi.cpp.

                                  {
 
    case IRP_MJ_READ:
 
        if (DmaDirection != WdfDmaDirectionReadFromDevice) {
            status = STATUS_INVALID_DEVICE_REQUEST;
 
            DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDMA,
                                "Dma direction %!WDF_DMA_DIRECTION! of WDFTRANSACTION "
                                "0x%p doesn't match with the WDFREQUEST 0x%p type "
                                "%!WDF_REQUEST_TYPE! %!STATUS!",
                                DmaDirection, DmaTransaction, Request,
                                stack->MajorFunction, status);
 
            return status;
        }
 
        reqLength = stack->Parameters.Read.Length;
 
        status = pReqObj->GetMdl(&mdl);
        break;
 
    case IRP_MJ_WRITE:
 
        if (DmaDirection != WdfDmaDirectionWriteToDevice) {
            status = STATUS_INVALID_DEVICE_REQUEST;
 
            DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDMA,
                                "Dma direction %!WDF_DMA_DIRECTION! of WDFTRANSACTION "
                                "0x%p doesn't match with the WDFREQUEST 0x%p type "
                                "%!WDF_REQUEST_TYPE! %!STATUS!",
                                DmaDirection, DmaTransaction, Request,
                                stack->MajorFunction, status);
 
            return status;
        }
 
        reqLength = stack->Parameters.Write.Length;
 
        status = pReqObj->GetMdl(&mdl);
        break;
 
    case IRP_MJ_DEVICE_CONTROL:
    case IRP_MJ_INTERNAL_DEVICE_CONTROL:
 
        switch (METHOD_FROM_CTL_CODE(stack->Parameters.DeviceIoControl.IoControlCode)) {
            case METHOD_BUFFERED:
 
                if (DmaDirection == WdfDmaDirectionWriteToDevice) {
                    reqLength = stack->Parameters.DeviceIoControl.InputBufferLength;
                } else {
                    reqLength = stack->Parameters.DeviceIoControl.OutputBufferLength;
                }
 
                //
                // In this case both input buffer and output buffer map
                // to the same MDL and it's probed for read & write access.
                // So it's okay for DMA transfer in either direction.
                //
                status = pReqObj->GetMdl(&mdl);
                break;
 
            case METHOD_IN_DIRECT:
                //
                // For this type, the output buffer is probed for read access.
                // So the direction of DMA transfer is WdfDmaDirectionWriteToDevice.
                //
                if (DmaDirection != WdfDmaDirectionWriteToDevice) {
 
                    status = STATUS_INVALID_DEVICE_REQUEST;
 
                    DoTraceLevelMessage(pFxDriverGlobals,
                                        TRACE_LEVEL_ERROR, TRACINGDMA,
                                        "Dma direction %!WDF_DMA_DIRECTION! of WDFTRANSACTION "
                                        "0x%p doesn't match with WDFREQUEST 0x%p ioctl type "
                                        "METHOD_IN_DIRECT %!STATUS!",
                                        DmaDirection, DmaTransaction, Request, status);
                    return status;
                }
 
                reqLength = stack->Parameters.DeviceIoControl.OutputBufferLength;
 
                status = pReqObj->GetDeviceControlOutputMdl(&mdl);
 
                break;
 
            case METHOD_OUT_DIRECT:
                //
                // For this type, the output buffer is probed for write access.
                // So the direction of DMA transfer is WdfDmaDirectionReadFromDevice.
                //
                if (DmaDirection != WdfDmaDirectionReadFromDevice) {
 
                    status = STATUS_INVALID_DEVICE_REQUEST;
 
                    DoTraceLevelMessage(pFxDriverGlobals,
                                        TRACE_LEVEL_ERROR, TRACINGDMA,
                                        "Dma direction %!WDF_DMA_DIRECTION! of WDFTRANSACTION "
                                        "0x%p doesn't match with WDFREQUEST 0x%p ioctl type "
                                        "METHOD_OUT_DIRECT %!STATUS!",
                                        DmaDirection, DmaTransaction, Request, status);
 
                    return status;
                }
 
                reqLength = stack->Parameters.DeviceIoControl.OutputBufferLength;
 
                status = pReqObj->GetDeviceControlOutputMdl(&mdl);
 
                break;
            default:
 
                status = STATUS_INVALID_DEVICE_REQUEST;
 
                DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDMA,
                                    "Invalid ioctl code in WDFREQUEST 0x%p %!STATUS!",
                                    Request, status);
 
                FxVerifierDbgBreakPoint(pFxDriverGlobals);
                break;
 
        }// End of switch(ioctType)
        break;
 
    default:
        status = STATUS_INVALID_DEVICE_REQUEST;
        break;
 
    }

Variable Documentation

Attributes

_Must_inspect_result_ __in WDFDMAENABLER __in_opt WDF_OBJECT_ATTRIBUTES* Attributes

Definition at line 44 of file fxdmatransactionapi.cpp.

ConfigureContext

__in WDFDMATRANSACTION __in_opt PFN_WDF_DMA_TRANSACTION_CONFIGURE_DMA_CHANNEL __in_opt PVOID ConfigureContext

Initial value:

{
    FxDmaTransactionBase* pDmaTrans

Definition at line 773 of file fxdmatransactionapi.cpp.

ConfigureRoutine

__in WDFDMATRANSACTION __in_opt PFN_WDF_DMA_TRANSACTION_CONFIGURE_DMA_CHANNEL ConfigureRoutine

Definition at line 771 of file fxdmatransactionapi.cpp.

Context

_Must_inspect_result_ __in WDFDMATRANSACTION __in_opt WDFCONTEXT Context

Initial value:

{
    FxDmaTransactionBase* pDmaTrans

Definition at line 529 of file fxdmatransactionapi.cpp.

DmaCompletionContext

__in WDFDMATRANSACTION __in_opt PFN_WDF_DMA_TRANSACTION_DMA_TRANSFER_COMPLETE __in_opt PVOID DmaCompletionContext

Initial value:

{
    FxDmaTransactionBase* pDmaTrans

Definition at line 822 of file fxdmatransactionapi.cpp.

DmaCompletionRoutine

__in WDFDMATRANSACTION __in_opt PFN_WDF_DMA_TRANSACTION_DMA_TRANSFER_COMPLETE DmaCompletionRoutine

Definition at line 820 of file fxdmatransactionapi.cpp.

DmaDirection

__in WDFDMATRANSACTION __in WDF_DMA_DIRECTION DmaDirection

Initial value:

{
    NTSTATUS status

Definition at line 123 of file fxdmatransactionapi.cpp.

Referenced by __drv_when().

DmaEnabler

_Must_inspect_result_ __in WDFDMAENABLER DmaEnabler

Definition at line 42 of file fxdmatransactionapi.cpp.

DmaTransaction

__in WDFDMATRANSACTION DmaTransaction

Initial value:

{
    FxDmaTransactionBase* pDmaTrans

Definition at line 117 of file fxdmatransactionapi.cpp.

Referenced by __drv_when().

DmaTransactionHandle

* DmaTransactionHandle

Initial value:

{
    NTSTATUS status

Definition at line 46 of file fxdmatransactionapi.cpp.

Referenced by switch().

else

else

Initial value:

{
        return NULL

Definition at line 719 of file fxdmatransactionapi.cpp.

EvtProgramDmaFunction

_Must_inspect_result_ __in WDFDMATRANSACTION __in PFN_WDF_PROGRAM_DMA EvtProgramDmaFunction

Definition at line 121 of file fxdmatransactionapi.cpp.

Referenced by __drv_when().

EvtReserveDmaContext

__in WDFDMATRANSACTION __in WDF_DMA_DIRECTION __in ULONG __in PFN_WDF_RESERVE_DMA __in PVOID EvtReserveDmaContext

Initial value:

{
    FxDmaPacketTransaction* pDmaTrans

Definition at line 1035 of file fxdmatransactionapi.cpp.

EvtReserveDmaFunction

__in WDFDMATRANSACTION __in WDF_DMA_DIRECTION __in ULONG __in PFN_WDF_RESERVE_DMA EvtReserveDmaFunction

Definition at line 1033 of file fxdmatransactionapi.cpp.

FinalTransferredLength

__in WDFDMATRANSACTION __in size_t FinalTransferredLength

Definition at line 634 of file fxdmatransactionapi.cpp.

MapRegisterCount

__in WDFDMATRANSACTION __out_opt ULONG* MapRegisterCount

Definition at line 965 of file fxdmatransactionapi.cpp.

MaximumLength

__in WDFDMATRANSACTION __in size_t MaximumLength

Initial value:

{
    FxDmaTransactionBase* pDmaTrans

Definition at line 684 of file fxdmatransactionapi.cpp.

mdl

MDL* mdl = NULL

Definition at line 129 of file fxdmatransactionapi.cpp.

Referenced by __attribute__(), FxDmaTransactionBase::_ComputeNextTransferAddress(), _Success_(), ClasspBuildDeviceMdl(), FreeBT_DispatchRead(), FreeBT_DispatchWrite(), FxDmaTransactionBase::GetTransferInfo(), if(), read_data(), FxDmaPacketTransaction::StageTransfer(), and switch().

Mdl

_Must_inspect_result_ __in WDFDMATRANSACTION __in PFN_WDF_PROGRAM_DMA __in WDF_DMA_DIRECTION __in PMDL Mdl

Definition at line 373 of file fxdmatransactionapi.cpp.

Referenced by __drv_when().

Offset

__in WDFDMATRANSACTION __in ULONG Offset

Initial value:

{
    FxDmaTransactionBase* pDmaTrans

Definition at line 375 of file fxdmatransactionapi.cpp.

Referenced by __drv_when().

pDmaEnabler

FxDmaEnabler* pDmaEnabler

Definition at line 50 of file fxdmatransactionapi.cpp.

Referenced by switch().

pDmaTrans

FxDmaTransactionBase* pDmaTrans

Definition at line 127 of file fxdmatransactionapi.cpp.

Referenced by __success(), and if().

pFxDriverGlobals

PFX_DRIVER_GLOBALS pFxDriverGlobals

Definition at line 51 of file fxdmatransactionapi.cpp.

Referenced by if(), and switch().

pReqObj

FxRequest* pReqObj

Definition at line 128 of file fxdmatransactionapi.cpp.

Referenced by switch().

pRequest

FxRequest * pRequest = pDmaTrans->GetRequest()

Definition at line 707 of file fxdmatransactionapi.cpp.

Referenced by FxUsbDevice::_CleanupPipesRequests(), FxRequest::_Create(), FxRequest::_CreateForPackage(), FxUsbPipe::_FormatTransfer(), FxIoTarget::_RequestCancelled(), FxIoQueue::AllocateReservedRequest(), BaseMemAllocator_SetProperties(), FxIoQueue::CancelForDriver(), FxIoQueue::DispatchRequestToDriver(), FxIoTarget::DrainPendedRequestsLocked(), FxPkgIo::EnqueueRequest(), FxIoQueue::FlushByFileObject(), FxUsbPipeContinuousReader::FormatRepeater(), FxIoQueue::ForwardRequest(), FxRequest::GetNextRequest(), FxIrpQueue::GetNextRequest(), FxIoQueue::GetRequest(), FxIoTarget::GetSentRequestsListLocked(), FxUsbPipe::GotoStartState(), CMiniportDMusUARTStream::HandlePortParams(), if(), FxPkgGeneral::OnCreate(), FxIoQueue::PeekRequest(), FxIrpQueue::PeekRequest(), CMallocSpy::PreDidAlloc(), CHeapPtrListMallocSpy::PreDidAlloc(), CMallocSpy::PreFree(), CHeapPtrListMallocSpy::PreFree(), CMallocSpy::PreGetSize(), CHeapPtrListMallocSpy::PreGetSize(), CMallocSpy::PreRealloc(), CHeapPtrListMallocSpy::PreRealloc(), FxIoQueue::QueuePurge(), FxIoQueue::QueueRequest(), FxIoQueue::QueueRequestFromForward(), FxIoQueue::RequestCancelable(), FxIoQueue::Requeue(), SeclCreateProcessWithLogonW(), CKsAllocator::SetProperties(), FxUsbDevice::Start(), and ValidatePropertyRequest().

profile

WDF_DMA_PROFILE profile = pDmaTrans->GetDmaEnabler()->GetProfile()

Definition at line 789 of file fxdmatransactionapi.cpp.

Referenced by if().

pStatus

__in WDFDMATRANSACTION __in size_t __out NTSTATUS * pStatus

Initial value:

{
    FxDmaTransactionBase    * pDmaTrans

Definition at line 577 of file fxdmatransactionapi.cpp.

Referenced by BitmapDecoderInfo_GetSigningStatus(), BitmapEncoderInfo_GetSigningStatus(), EnumJobsA(), FormatConverterInfo_GetSigningStatus(), INetCfgComponent_fnGetDeviceStatus(), PixelFormatInfo_GetSigningStatus(), PrintService(), PrintServiceStatus(), and Query().

reqLength

reqLength = 0

Definition at line 131 of file fxdmatransactionapi.cpp.

Referenced by if(), and switch().

Request

_Must_inspect_result_ __in WDFDMATRANSACTION __in WDFREQUEST Request

Definition at line 119 of file fxdmatransactionapi.cpp.

RequiredMapRegisters

__in WDFDMATRANSACTION __in WDF_DMA_DIRECTION __in ULONG RequiredMapRegisters

Definition at line 1031 of file fxdmatransactionapi.cpp.

return

return

Definition at line 1168 of file fxdmatransactionapi.cpp.

ScatterGatherElementCount

__in WDFDMATRANSACTION __out_opt ULONG __out_opt ULONG* ScatterGatherElementCount

Initial value:

{
    FxDmaTransactionBase* pDmaTrans

Definition at line 967 of file fxdmatransactionapi.cpp.

stack

stack = pReqObj->GetFxIrp()->GetCurrentIrpStackLocation()

Definition at line 130 of file fxdmatransactionapi.cpp.

state

FxDmaTransactionState state = pDmaTrans->GetTransactionState()

Definition at line 937 of file fxdmatransactionapi.cpp.

Referenced by if().

status

return status

Initial value:

= FxValidateObjectAttributes(pFxDriverGlobals,
                                        Attributes,
                                        FX_VALIDATE_OPTION_PARENT_NOT_ALLOWED
                                        )

Definition at line 63 of file fxdmatransactionapi.cpp.

Referenced by if(), and switch().

STATUS_SUCCESS

return STATUS_SUCCESS

Definition at line 356 of file fxdmatransactionapi.cpp.

systemTransaction

FxDmaSystemTransaction * systemTransaction = (FxDmaSystemTransaction*) pDmaTrans

Definition at line 807 of file fxdmatransactionapi.cpp.

Referenced by FxDmaPacketTransaction::_AdapterControl(), and FxDmaPacketTransaction::StageTransfer().

TransferredLength

__in WDFDMATRANSACTION __in size_t TransferredLength

Definition at line 604 of file fxdmatransactionapi.cpp.

UseImmediateExecution

__in WDFDMATRANSACTION __in BOOLEAN UseImmediateExecution

Initial value:

{
    FxDmaTransactionBase* pDmaTrans

Definition at line 994 of file fxdmatransactionapi.cpp.

VirtualAddress

_Must_inspect_result_ __in WDFDMATRANSACTION __in PFN_WDF_PROGRAM_DMA __in WDF_DMA_DIRECTION __in PMDL __in PVOID VirtualAddress

Definition at line 415 of file fxdmatransactionapi.cpp.