hDiveInst (HDIVE) - input
Display
engine DIVE instance.
pulBufferNumber (PULONG) - output
Buffer number allocated for this instance.
fccColorSpace (FOURCC) - input
Indicates pel format of image color space this buffer
will contain.
ulWidth (ULONG) - input
Indicates
width (in pels) of DIVE memory to allocate.
ulHeight (ULONG) - input
Indicates
height (in pels) of DIVE memory to allocate.
ulLineSizeBytes (ULONG) - input
Suggested scan line size for allocated buffer. Setting
ulLineSizeBytes to 0 allows DIVE to calculate the optimum line size.
pbImageBuffer (PBYTE) - input
Use
pbImageBuffer to associate a buffer (that has already been allocated
by some means other than DIVE) to a DIVE buffer number. You must still
call DiveFreeImageBuffer to
free up the associated buffer and deallocate the buffer using the same means
in which it was allocated.
rc (ULONG) - returns
Return
codes indicating success or type of failure:
DIVE_SUCCESS
If the function succeeds, 0 is returned.
DIVE_ERR_ALLOCATION_ERROR
The
hardware-blitter memory allocation failed.
DIVE_ERR_INVALID_BUFFER_NUMBER
The parameter pulBufferNumber must either
point to zero (a newly associated buffer) or a currently associated buffer
number (to reassociate the buffer to a new pointer).
DIVE_ERR_INVALID_INSTANCE
The DIVE instance handle specified in the hDiveInst
parameter is invalid.
DIVE_ERR_INVALID_LINESIZE
The scan line size specified in the ulLineSizeBytes
parameter is invalid.
DIVE_ERR_SOURCE_FORMAT
The source format is not a recognized FOURCC.
DIVE_ERR_TOO_MANY_INSTANCES
There are not enough resources for another DIVE
instance.
[Back: DiveAllocImageBuffer Return Value - rc]
[Next: DiveAllocImageBuffer - Remarks]