fxmemorybufferpreallocatedapi.cpp File Reference

#include "coreprivshared.hpp"
#include "fxmemorybufferpreallocated.hpp"

Include dependency graph for fxmemorybufferpreallocatedapi.cpp:

Go to the source code of this file.

Functions
_Must_inspect_result_	__drv_maxIRQL (DISPATCH_LEVEL) WDFAPI NTSTATUS NTAPI WDFEXPORT(WdfMemoryCreatePreallocated)(__in PWDF_DRIVER_GLOBALS DriverGlobals
_Must_inspect_result_ __in_opt PWDF_OBJECT_ATTRIBUTES __in PVOID __in	__drv_when (BufferSize==0, __drv_reportError(BufferSize cannot be zero)) size_t BufferSize
	if (NT_SUCCESS(FxValidateObjectAttributesForParentHandle(pFxDriverGlobals, Attributes)))
	FxPointerNotNull (pFxDriverGlobals, Buffer)
	FxPointerNotNull (pFxDriverGlobals, PMemory)
	if (BufferSize==0)
	if (!NT_SUCCESS(status))
	if (pBuffer==NULL)
	if (NT_SUCCESS(status))
_Must_inspect_result_ _In_ WDFMEMORY _Pre_notnull_	_Pre_writable_byte_size_ (BufferSize) PVOID Buffer

Variables
_Must_inspect_result_ __in_opt PWDF_OBJECT_ATTRIBUTES	Attributes
_Must_inspect_result_ __in_opt PWDF_OBJECT_ATTRIBUTES __in PVOID	Buffer
_Must_inspect_result_ __in_opt PWDF_OBJECT_ATTRIBUTES __in PVOID __in __out WDFMEMORY *	PMemory
PFX_DRIVER_GLOBALS	pFxDriverGlobals = GetFxDriverGlobals(DriverGlobals)
FxMemoryBufferPreallocated *	pBuffer
WDFMEMORY	hMemory
NTSTATUS	status = FxValidateObjectAttributes(pFxDriverGlobals, Attributes)
	else
_Must_inspect_result_ _In_ WDFMEMORY	Memory

Function Documentation

__drv_maxIRQL()

_Must_inspect_result_ __drv_maxIRQL

(

DISPATCH_LEVEL

)

__drv_when()

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

Definition at line 149 of file fxmemorybufferpreallocatedapi.cpp.

{
    DDI_ENTRY();
 
    PFX_DRIVER_GLOBALS pFxDriverGlobals;
    NTSTATUS status;
    FxMemoryBufferPreallocated* pMemory;
 
    FxObjectHandleGetPtrAndGlobals(GetFxDriverGlobals(DriverGlobals),
                                   Memory,
                                   FX_TYPE_MEMORY_PREALLOCATED,
                                   (PVOID*) &pMemory,
                                   &pFxDriverGlobals);
 
    FxPointerNotNull(pFxDriverGlobals, Buffer);
 
    if (BufferSize == 0) {
        status = STATUS_INVALID_PARAMETER;
        DoTraceLevelMessage(pFxDriverGlobals, TRACE_LEVEL_ERROR, TRACINGDEVICE,
                            "Zero BufferSize not allowed, %!STATUS!", status);
        return status;
    }
 
    pMemory->UpdateBuffer(Buffer, BufferSize);
 
    return STATUS_SUCCESS;
}

_Pre_writable_byte_size_()

_Must_inspect_result_ _In_ WDFMEMORY _Pre_notnull_ _Pre_writable_byte_size_

(

BufferSize

)

FxPointerNotNull() [1/2]

FxPointerNotNull	(	pFxDriverGlobals	,
		Buffer
	)

FxPointerNotNull() [2/2]

FxPointerNotNull	(	pFxDriverGlobals	,
		PMemory
	)

if() [1/5]

if

(

!

NT_SUCCESSstatus

)

Definition at line 113 of file fxmemorybufferpreallocatedapi.cpp.

                             {
        return status;
    }

if() [2/5]

if

(

BufferSize

= = 0

)

Definition at line 105 of file fxmemorybufferpreallocatedapi.cpp.

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

if() [3/5]

if

(

NT_SUCCESS(FxValidateObjectAttributesForParentHandle(pFxDriverGlobals, Attributes))

)

Definition at line 89 of file fxmemorybufferpreallocatedapi.cpp.

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

if() [4/5]

if

(

NT_SUCCESS(status)

)

Definition at line 126 of file fxmemorybufferpreallocatedapi.cpp.

                            {
        *PMemory = hMemory;
    }

if() [5/5]

if

(

pBuffer

= = NULL

)

Definition at line 120 of file fxmemorybufferpreallocatedapi.cpp.

                         {
        return STATUS_INSUFFICIENT_RESOURCES;
    }

Variable Documentation

Attributes

_Must_inspect_result_ __in_opt PWDF_OBJECT_ATTRIBUTES Attributes

Definition at line 42 of file fxmemorybufferpreallocatedapi.cpp.

Buffer

_Must_inspect_result_ __in_opt PWDF_OBJECT_ATTRIBUTES __in PVOID Buffer

Definition at line 44 of file fxmemorybufferpreallocatedapi.cpp.

else

else

Initial value:

{
        pBuffer->DeleteFromFailedCreate()

Definition at line 129 of file fxmemorybufferpreallocatedapi.cpp.

hMemory

WDFMEMORY hMemory

Definition at line 81 of file fxmemorybufferpreallocatedapi.cpp.

Referenced by if().

Memory

_Must_inspect_result_ _In_ WDFMEMORY Memory

Definition at line 145 of file fxmemorybufferpreallocatedapi.cpp.

pBuffer

pBuffer

Initial value:

= new(pFxDriverGlobals, Attributes)
            FxMemoryBufferPreallocated(pFxDriverGlobals, Buffer, BufferSize)

Definition at line 80 of file fxmemorybufferpreallocatedapi.cpp.

pFxDriverGlobals

pFxDriverGlobals = GetFxDriverGlobals(DriverGlobals)

Definition at line 79 of file fxmemorybufferpreallocatedapi.cpp.

Referenced by __drv_when(), and if().

PMemory

* PMemory

Initial value:

{
    DDI_ENTRY()

Definition at line 49 of file fxmemorybufferpreallocatedapi.cpp.

Referenced by if().

status

return status = FxValidateObjectAttributes(pFxDriverGlobals, Attributes)

Definition at line 82 of file fxmemorybufferpreallocatedapi.cpp.

Referenced by __drv_when(), and if().