VideoPortAllocateBuffer function (video.h)

The VideoPortAllocateBuffer function is obsolete in Windows 2000 and later. In its place, video miniport drivers should instead use VideoPortAllocatePool.

VideoPortAllocateBuffer allocates a buffer of paged pool memory.

Syntax

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortAllocateBuffer(
  [in]  IN PVOID  HwDeviceExtension,
  [in]  IN ULONG  Size,
  [out] OUT PVOID *Buffer
);

Parameters

[in] HwDeviceExtension

Pointer to the miniport driver's device extension.

[in] Size

Specifies the size of the buffer to allocate, in bytes.

[out] Buffer

Is the location in which the video port driver returns a pointer to a pointer to the allocated pool memory.

Return value

VideoPortAllocateBuffer returns NO_ERROR when it successfully completes the allocation request, or ERROR_NOT_ENOUGH_MEMORY if it is unable to allocate a buffer of Size bytes. A return value of ERROR_INSUFFICIENT_BUFFER indicates that a miniport driver has exceeded its maximum allowable allocation of memory.

Remarks

A miniport driver can use the return value of this function to determine whether the buffer allocation succeeded.

Requirements

Requirement	Value
Minimum supported client	Available in Windows 2000 and later versions of the Windows operating systems.
Target Platform	Desktop
Header	video.h (include Video.h)
Library	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL

See also

VideoPortReleaseBuffer