AgpAllocatePool routine

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

Syntax


DXGKCB_AGP_ALLOCATE_POOL AgpAllocatePool;

NTSTATUS APIENTRY AgpAllocatePool(
  _In_   HANDLE Context,
  _In_   ULONG AllocationSize,
  _In_   MEMORY_CACHING_TYPE CacheType,
  _Out_  PPHYSICAL_ADDRESS PhysicalAddress,
  _Out_  PVOID *VirtualAddress
)
{ ... }

Parameters

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.

AllocationSize [in]

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

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.

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.

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

Version

Available in Windows Vista and later versions of the Windows operating systems.

Header

Dispmprt.h (include Dispmprt.h)

IRQL

PASSIVE_LEVEL

See also

AgpFreePool
AgpSetCommand
DXGK_AGP_INTERFACE
DxgkCbQueryServices

 

 

Send comments about this topic to Microsoft

Show:
© 2014 Microsoft