Edit

Share via

VideoPortAllocateBuffer function (video.h)

  • Article

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