#include "fxdmapch.hpp"

Include dependency graph for fxcommonbufferapi.cpp:

Functions
_Must_inspect_result_	__drv_maxIRQL (PASSIVE_LEVEL) NTSTATUS NTAPI WDFEXPORT(WdfCommonBufferCreate)(__in PWDF_DRIVER_GLOBALS DriverGlobals

_Must_inspect_result_ __in WDFDMAENABLER __in	__drv_when (Length==0, __drv_reportError(Length cannot be zero)) size_t Length

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

	FxPointerNotNull (pFxDriverGlobals, CommonBufferHandle)

	if (!NT_SUCCESS(status))

	if (Length==0)

	if (pComBuf==NULL)

	if (NT_SUCCESS(status))

	FxPointerNotNull (pFxDriverGlobals, Config)

	if (Config->Size !=sizeof(WDF_COMMON_BUFFER_CONFIG))

	__drv_maxIRQL (DISPATCH_LEVEL) PVOID NTAPI WDFEXPORT(WdfCommonBufferGetAlignedVirtualAddress)(__in PWDF_DRIVER_GLOBALS DriverGlobals

	FxObjectHandleGetPtr (GetFxDriverGlobals(DriverGlobals), CommonBuffer, FX_TYPE_COMMON_BUFFER,(PVOID *) &pComBuf)

return pComBuf	GetAlignedVirtualAddress ()

return pComBuf	GetAlignedLogicalAddress ()

return pComBuf	GetLength ()

Variables
_Must_inspect_result_ __in WDFDMAENABLER	DmaEnabler

_Must_inspect_result_ __in WDFDMAENABLER __in __in_opt WDF_OBJECT_ATTRIBUTES *	Attributes

_Must_inspect_result_ __in WDFDMAENABLER __in __in_opt WDF_OBJECT_ATTRIBUTES __out WDFCOMMONBUFFER *	CommonBufferHandle

FxDmaEnabler *	pDmaEnabler

NTSTATUS	status = FxVerifierCheckIrqlLevel(pFxDriverGlobals, PASSIVE_LEVEL)

WDFOBJECT	handle

PFX_DRIVER_GLOBALS	pFxDriverGlobals

	pComBuf

	else

_Must_inspect_result_ __in WDFDMAENABLER __in __in PWDF_COMMON_BUFFER_CONFIG	Config

__in WDFCOMMONBUFFER	CommonBuffer

Function Documentation

◆ __drv_maxIRQL() [1/2]

__drv_maxIRQL ( DISPATCH_LEVEL )

◆ __drv_maxIRQL() [2/2]

_Must_inspect_result_ __drv_maxIRQL ( PASSIVE_LEVEL )

◆ __drv_when()

_Must_inspect_result_ __in WDFDMAENABLER __in __drv_when	(	Length	= `= 0`,
		__drv_reportError(Length cannot be zero)
	)

◆ FxObjectHandleGetPtr()

FxObjectHandleGetPtr	(	GetFxDriverGlobals(DriverGlobals)	,
		CommonBuffer	,
		FX_TYPE_COMMON_BUFFER	,
		(PVOID *) &	pComBuf
	)

◆ FxObjectHandleGetPtrAndGlobals()

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

◆ FxPointerNotNull() [1/2]

FxPointerNotNull	(	pFxDriverGlobals	,
		CommonBufferHandle
	)

◆ FxPointerNotNull() [2/2]

FxPointerNotNull	(	pFxDriverGlobals	,
		Config
	)

◆ GetAlignedLogicalAddress()

return pComBuf GetAlignedLogicalAddress ( )

◆ GetAlignedVirtualAddress()

return pComBuf GetAlignedVirtualAddress ( )

◆ GetLength()

return pComBuf GetLength ( )

Referenced by DECLARE_INTERFACE_().

◆ if() [1/5]

if ( ! NT_SUCCESSstatus )

Definition at line 73 of file fxcommonbufferapi.cpp.

                             {
        return status;
    }

◆ if() [2/5]

if ( Config->Size ! = sizeof(WDF_COMMON_BUFFER_CONFIG) )

Definition at line 175 of file fxcommonbufferapi.cpp.

                                                          {
        status = STATUS_INFO_LENGTH_MISMATCH;
 
        DoTraceLevelMessage(
            pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDMA,
            "WDF_COMMON_BUFFER_CONFIG Size 0x%x, expected 0x%x, %!STATUS!",
            Config->Size, sizeof(WDF_COMMON_BUFFER_CONFIG), status);
 
        return status;
    }

◆ if() [3/5]

if ( Length = = 0 )

Definition at line 80 of file fxcommonbufferapi.cpp.

                     {
        status = STATUS_INVALID_PARAMETER;
        DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDMA,
                            "Length is 0, %!STATUS!", status);
        return status;
    }

◆ if() [4/5]

if ( NT_SUCCESS(status) )

Definition at line 115 of file fxcommonbufferapi.cpp.

                            {
        //
        // Ok: now allocate a CommonBuffer via this DmaEnabler
        //
        status = pComBuf->AllocateCommonBuffer( Length );
    }

◆ if() [5/5]

if ( pComBuf = = NULL )

Definition at line 101 of file fxcommonbufferapi.cpp.

                         {
        status = STATUS_INSUFFICIENT_RESOURCES;
 
        DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDMA,
                            "Could not allocate memory for a WDFCOMMONBUFFER, "
                            "%!STATUS!", status);
        return status;
    }