fxlookasidelistapi.cpp File Reference

#include "coreprivshared.hpp"
#include "fxnpagedlookasidelist.hpp"
#include "fxpagedlookasidelist.hpp"

Include dependency graph for fxlookasidelistapi.cpp:

Go to the source code of this file.

Functions
_Must_inspect_result_	__drv_when (PoolType==1||PoolType==257, __drv_maxIRQL(APC_LEVEL)) __drv_when(PoolType
_Must_inspect_result_	__drv_maxIRQL (DISPATCH_LEVEL)) NTSTATUS WDFAPI NTAPI WDFEXPORT(WdfLookasideListCreate)(__in PWDF_DRIVER_GLOBALS DriverGlobals
_Must_inspect_result_ __in_opt PWDF_OBJECT_ATTRIBUTES __in	__drv_when (BufferSize==0, __drv_reportError(BufferSize cannot be zero)) size_t BufferSize
_Must_inspect_result_ __in_opt PWDF_OBJECT_ATTRIBUTES __in __in	__drv_strictTypeMatch (__drv_typeExpr) POOL_TYPE PoolType
	if (NT_SUCCESS(FxValidateObjectAttributesForParentHandle(pFxDriverGlobals, LookasideAttributes)))
else	if (NT_SUCCESS(FxValidateObjectAttributesForParentHandle(pFxDriverGlobals, MemoryAttributes)))
	FxPointerNotNull (pFxDriverGlobals, PLookaside)
	if (BufferSize==0)
	if (!NT_SUCCESS(status))
	if (PoolTag==0)
	FxVerifierCheckNxPoolType (pFxDriverGlobals, PoolType, PoolTag)
	if (FxIsPagedPoolType(PoolType)==FALSE)
	if (pLookasideDB !=NULL &&pMemoryDB !=NULL &&pLookasideDB !=pMemoryDB)
	if (pLookaside==NULL)
	if (NT_SUCCESS(status))
	FxObjectHandleGetPtr (GetFxDriverGlobals(DriverGlobals), Lookaside, FX_TYPE_LOOKASIDE,(PVOID *)&pLookaside)
	FxPointerNotNull (pLookaside->GetDriverGlobals(), Memory)

Variables
_Must_inspect_result_ __in_opt PWDF_OBJECT_ATTRIBUTES	LookasideAttributes
_Must_inspect_result_ __in_opt PWDF_OBJECT_ATTRIBUTES __in __in __in_opt PWDF_OBJECT_ATTRIBUTES	MemoryAttributes
_Must_inspect_result_ __in_opt PWDF_OBJECT_ATTRIBUTES __in __in __in_opt PWDF_OBJECT_ATTRIBUTES __in_opt ULONG	PoolTag
_Must_inspect_result_ __in_opt PWDF_OBJECT_ATTRIBUTES __in __in __in_opt PWDF_OBJECT_ATTRIBUTES __in_opt ULONG __out WDFLOOKASIDE *	PLookaside
FxLookasideList *	pLookaside
WDFLOOKASIDE	hLookaside = NULL
NTSTATUS	status = FxValidateObjectAttributes(pFxDriverGlobals, LookasideAttributes)
FxObject *	pParent = NULL
	pFxDriverGlobals = GetFxDriverGlobals(DriverGlobals)
	else
	pLookasideDB
	pMemoryDB
_Must_inspect_result_ __in WDFLOOKASIDE	Lookaside
_Must_inspect_result_ __in WDFLOOKASIDE __out WDFMEMORY *	Memory
FxMemoryObject *	pMemory = NULL
WDFMEMORY	hMemory

Function Documentation

__drv_maxIRQL()

_Must_inspect_result_ __drv_maxIRQL

(

DISPATCH_LEVEL

)

__drv_strictTypeMatch()

_Must_inspect_result_ __in_opt PWDF_OBJECT_ATTRIBUTES __in __in __drv_strictTypeMatch

(

__drv_typeExpr

)

__drv_when() [1/2]

_Must_inspect_result_ __in_opt PWDF_OBJECT_ATTRIBUTES __in __drv_when	(	BufferSize	= = 0,
		__drv_reportError(BufferSize cannot be zero)
	)

__drv_when() [2/2]

_Must_inspect_result_ __drv_when	(	PoolType	= = 1 || PoolType == 257,
		__drv_maxIRQL(APC_LEVEL)
	)

FxObjectHandleGetPtr()

FxObjectHandleGetPtr	(	GetFxDriverGlobals(DriverGlobals)	,
		Lookaside	,
		FX_TYPE_LOOKASIDE	,
		(PVOID *)&	pLookaside
	)

FxPointerNotNull() [1/2]

FxPointerNotNull	(	pFxDriverGlobals	,
		PLookaside
	)

FxPointerNotNull() [2/2]

FxPointerNotNull	(	pLookaside->	GetDriverGlobals(),
		Memory
	)

FxVerifierCheckNxPoolType()

FxVerifierCheckNxPoolType	(	pFxDriverGlobals	,
		PoolType	,
		PoolTag
	)

if() [1/9]

if

(

!

NT_SUCCESSstatus

)

Definition at line 136 of file fxlookasidelistapi.cpp.

                             {
        return status;
    }

if() [2/9]

if

(

BufferSize

= = 0

)

Definition at line 128 of file fxlookasidelistapi.cpp.

                         {
        status = STATUS_INVALID_PARAMETER;
        DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                            "Zero BufferSize not allowed, %!STATUS!", status);
        return status;
    }

if() [3/9]

if

(

FxIsPagedPoolType(PoolType)

= = FALSE

)

Definition at line 154 of file fxlookasidelistapi.cpp.

                                              {
        if (BufferSize < PAGE_SIZE) {
            pLookaside = new(pFxDriverGlobals, LookasideAttributes)
                FxNPagedLookasideList(pFxDriverGlobals, PoolTag);
        }
        else {
            pLookaside = new(pFxDriverGlobals, LookasideAttributes)
                FxNPagedLookasideListFromPool(pFxDriverGlobals, PoolTag);
        }
    }

if() [4/9]

if

(

NT_SUCCESS(FxValidateObjectAttributesForParentHandle( pFxDriverGlobals, LookasideAttributes))

)

Definition at line 104 of file fxlookasidelistapi.cpp.

                                               {
        FxObjectHandleGetPtrAndGlobals(pFxDriverGlobals,
                                       LookasideAttributes->ParentObject,
                                       FX_TYPE_OBJECT,
                                       (PVOID*)&pParent,
                                       &pFxDriverGlobals);
    }

if() [5/9]

else if

(

NT_SUCCESS(FxValidateObjectAttributesForParentHandle( pFxDriverGlobals, MemoryAttributes))

)

Definition at line 113 of file fxlookasidelistapi.cpp.

                                                {
        FxObjectHandleGetPtrAndGlobals(pFxDriverGlobals,
                                       MemoryAttributes->ParentObject,
                                       FX_TYPE_OBJECT,
                                       (PVOID*)&pParent,
                                       &pFxDriverGlobals);
    }

if() [6/9]

if

(

NT_SUCCESS(status)

)

Definition at line 217 of file fxlookasidelistapi.cpp.

                            {
        //
        // Follow the global driver policy and either return a PVOID cookie or
        // an index into a handle table.
        //
        status = pLookaside->Commit(LookasideAttributes, (WDFOBJECT*)&hLookaside);
    }

if() [7/9]

if

(

pLookaside

= = NULL

)

Definition at line 211 of file fxlookasidelistapi.cpp.

                            {
        return STATUS_INSUFFICIENT_RESOURCES;
    }

if() [8/9]

if

(

pLookasideDB !

= NULL && pMemoryDB != NULL && pLookasideDB != pMemoryDB

)

Definition at line 178 of file fxlookasidelistapi.cpp.

                                       {
            status = STATUS_INVALID_PARAMETER;
 
            //
            // No need to check if LookasideAttributes or MemoryAttributes are
            // equal to NULL b/c we could not get a valid pLookasideDB or
            // pMemoryDB if they were NULL.
            //
            DoTraceLevelMessage(
                pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                "Lookaside Attributes ancestor WDFDEVICE %p (from ParentObject %p) "
                " is not the same as Memory Attributes ancestor WDFDEVICE %p "
                "(from ParentObject %p), %!STATUS!",
                pLookasideDB->GetHandle(), LookasideAttributes->ParentObject,
                pMemoryDB->GetHandle(), MemoryAttributes->ParentObject,
                status);
 
            return status;
        }

if() [9/9]

if

(

PoolTag

= = 0

)

Definition at line 145 of file fxlookasidelistapi.cpp.

                      {
        PoolTag = pFxDriverGlobals->Tag;
    }

Variable Documentation

else

else

Initial value:

{
        FxDeviceBase* pLookasideDB, *pMemoryDB

Definition at line 164 of file fxlookasidelistapi.cpp.

hLookaside

hLookaside = NULL

Definition at line 94 of file fxlookasidelistapi.cpp.

Referenced by if().

hMemory

WDFMEMORY hMemory

Definition at line 266 of file fxlookasidelistapi.cpp.

Referenced by CloseSharedMemory(), FxUsbDevice::CreateIsochUrb(), FxUsbDevice::CreateUrb(), GlobalAlloc(), HEADER_CreateDragImage(), load_string(), LocalAlloc(), NPCancelConnection(), NPEnumResource(), NPGetConnection(), and StoreConnectionInfo().

Lookaside

_Must_inspect_result_ __in WDFLOOKASIDE Lookaside

Definition at line 244 of file fxlookasidelistapi.cpp.

LookasideAttributes

_Must_inspect_result_ __in_opt PWDF_OBJECT_ATTRIBUTES LookasideAttributes

Definition at line 44 of file fxlookasidelistapi.cpp.

Referenced by if().

Memory

* Memory

Initial value:

{
    FxLookasideList* pLookaside

Definition at line 246 of file fxlookasidelistapi.cpp.

MemoryAttributes

_Must_inspect_result_ __in_opt PWDF_OBJECT_ATTRIBUTES __in __in __in_opt PWDF_OBJECT_ATTRIBUTES MemoryAttributes

Definition at line 52 of file fxlookasidelistapi.cpp.

pFxDriverGlobals

pFxDriverGlobals = GetFxDriverGlobals(DriverGlobals)

Definition at line 99 of file fxlookasidelistapi.cpp.

Referenced by if().

PLookaside

* PLookaside

Initial value:

{
    PFX_DRIVER_GLOBALS pFxDriverGlobals

Definition at line 56 of file fxlookasidelistapi.cpp.

pLookaside

pLookaside

Initial value:

= new(pFxDriverGlobals, LookasideAttributes)
            FxPagedLookasideListFromPool(pFxDriverGlobals,
                                         PoolTag,
                                         pLookasideDB,
                                         pMemoryDB)

Definition at line 93 of file fxlookasidelistapi.cpp.

Referenced by if(), and FxMemoryBufferFromLookaside::SelfDestruct().

pLookasideDB

pLookasideDB

Initial value:

= FxDeviceBase::_SearchForDevice(pFxDriverGlobals,
                                                       LookasideAttributes)

Definition at line 172 of file fxlookasidelistapi.cpp.

Referenced by if().

pMemory

IFxMemory * pMemory = NULL

Definition at line 265 of file fxlookasidelistapi.cpp.

Referenced by __drv_when(), FxDevice::_AllocAndQueryProperty(), FxDevice::_AllocAndQueryPropertyEx(), FxUsbPipe::_FormatTransfer(), array_buffer_size(), array_compute_and_size_conformance(), array_compute_and_write_conformance(), array_free(), array_read_variance_and_unmarshall(), array_write_variance_and_marshall(), call_buffer_sizer(), call_freer(), call_marshaller(), CloseSharedMemory(), ComplexBufferSize(), ComplexFree(), ComplexMarshall(), ComplexUnmarshall(), ComputeConformance(), ComputeConformanceOrVariance(), ComputeVariance(), FxRequestMemory::Create(), EmbeddedPointerBufferSize(), EmbeddedPointerFree(), EmbeddedPointerMarshall(), FxUsbPipeContinuousReader::FormatRepeater(), get_discriminant(), get_ip_iid(), NdrBaseTypeBufferSize(), NdrBaseTypeFree(), NdrBaseTypeMarshall(), NdrComplexArrayBufferSize(), NdrComplexArrayFree(), NdrComplexArrayMarshall(), NdrComplexStructBufferSize(), NdrComplexStructFree(), NdrComplexStructMarshall(), NdrComplexStructUnmarshall(), NdrConformantArrayBufferSize(), NdrConformantArrayFree(), NdrConformantArrayMarshall(), NdrConformantStringBufferSize(), NdrConformantStructBufferSize(), NdrConformantStructFree(), NdrConformantStructMarshall(), NdrConformantVaryingArrayBufferSize(), NdrConformantVaryingArrayFree(), NdrConformantVaryingArrayMarshall(), NdrConformantVaryingStructBufferSize(), NdrConformantVaryingStructFree(), NdrConformantVaryingStructMarshall(), NdrContextHandleBufferSize(), NdrContextHandleMarshall(), NdrContextHandleSize(), NdrCorrelationInitialize(), NdrEncapsulatedUnionBufferSize(), NdrEncapsulatedUnionFree(), NdrEncapsulatedUnionMarshall(), NdrFixedArrayBufferSize(), NdrFixedArrayFree(), NdrFixedArrayMarshall(), NdrInterfacePointerBufferSize(), NdrInterfacePointerFree(), NdrInterfacePointerMarshall(), NdrNonConformantStringBufferSize(), NdrNonConformantStringMarshall(), NdrNonEncapsulatedUnionBufferSize(), NdrNonEncapsulatedUnionFree(), NdrNonEncapsulatedUnionMarshall(), NdrPointerBufferSize(), NdrPointerFree(), NdrPointerMarshall(), NdrRangeBufferSize(), NdrRangeFree(), NdrRangeMarshall(), NdrSimpleStructBufferSize(), NdrSimpleStructFree(), NdrSimpleStructMarshall(), NdrSimpleTypeMarshall(), NdrSimpleTypeUnmarshall(), NdrUserMarshalBufferSize(), NdrUserMarshalFree(), NdrUserMarshalMarshall(), NdrVaryingArrayBufferSize(), NdrVaryingArrayFree(), NdrVaryingArrayMarshall(), OpenSharedMemory(), FxRequest::ProbeAndLockForRead(), FxRequest::ProbeAndLockForWrite(), START_TEST(), union_arm_buffer_size(), union_arm_free(), union_arm_marshall(), FxRequestBuffer::ValidateMemoryDescriptor(), and WTSFreeMemory().

pMemoryDB

pMemoryDB

Initial value:

= FxDeviceBase::_SearchForDevice(pFxDriverGlobals,
                                                   MemoryAttributes)

Definition at line 175 of file fxlookasidelistapi.cpp.

Referenced by if().

PoolTag

_Must_inspect_result_ __in_opt PWDF_OBJECT_ATTRIBUTES __in __in __in_opt PWDF_OBJECT_ATTRIBUTES __in_opt ULONG PoolTag

Definition at line 54 of file fxlookasidelistapi.cpp.

pParent

pParent = NULL

Definition at line 96 of file fxlookasidelistapi.cpp.

Referenced by if().

status

return status = FxValidateObjectAttributes(pFxDriverGlobals, LookasideAttributes)

Definition at line 95 of file fxlookasidelistapi.cpp.

Referenced by if().