DXGKCB_AGP_ALLOCATE_POOL callback function

The AgpAllocatePool function reserves, commits, and maps AGP memory.

Syntax

DXGKCB_AGP_ALLOCATE_POOL DxgkcbAgpAllocatePool;

NTSTATUS DxgkcbAgpAllocatePool(
  IN HANDLE,
  IN ULONG,
  IN MEMORY_CACHING_TYPE,
  OUT PPHYSICAL_ADDRESS,
  OUT PVOID
)
{...}

Parameters

HANDLE

Context [in]

A handle to a context block associated with an AGP interface. The display miniport driver previously received this handle in the Context member of the DXGK_AGP_INTERFACE structure that was filled in by DxgkCbQueryServices.

ULONG

AllocationSize [in]

The size, in bytes, of the AGP memory to be allocated.

MEMORY_CACHING_TYPE

CacheType [in]

A constant from the MEMORY_CACHING_TYPE enumeration that specifies whether the CPU can use caching or write combining when it accesses the allocated AGP memory.

PPHYSICAL_ADDRESS

PhysicalAddress [out]

A pointer to a PHYSICAL_ADDRESS structure that receives the base physical address of the AGP allocation. This is the base of the physical address range that the GPU will use to access the AGP memory.

PVOID

VirtualAddress [out]

A pointer to a variable that receives the base virtual address, in system space, of the AGP allocation. This is the base of the virtual address range that the CPU will use to access the AGP memory.

Return Value

AgpAllocatePool returns STATUS_SUCCESS if it succeeds. Otherwise, it returns one of the error codes defined in Ntstatus.h.

Remarks

Call AgpAllocatePool in the display miniport driver's DxgkDdiStartDevice function. It is likely that AgpAllocatePool will fail if you call it after DxgkDdiStartDevice has executed.

Requirements

   
Minimum supported client Available in Windows Vista and later versions of the Windows operating systems.
Target Platform Desktop
Header dispmprt.h (include Dispmprt.h)
IRQL PASSIVE_LEVEL

See Also

AgpFreePool

AgpSetCommand

DXGK_AGP_INTERFACE

DxgkCbQueryServices