IServerVirtualDeviceSet2::AllocateBuffer

Microsoft SQL Server Virtual Backup

Microsoft SQL Server Virtual Backup Device Specification

IServerVirtualDeviceSet2::AllocateBuffer

Purpose This function obtains a shared memory buffer from the virtual device set.
Syntax HRESULT IServerVirtualDeviceSet2::AllocateBuffer (

   LPVOID*      ppBuffer,

   UINT32      dwSize,

   UINT32      dwAlignment

);

Parameters Argument Explanation
  ppBuffer This returns a pointer to the start of the buffer.
  dwSize This is the size of the buffer in bytes. This does not include any prefix zone requested by the client. Any such zone is hidden from the server and there will be space available prior to when the buffer address is returned.
  dwAlignment This specifies the alignment boundary for the buffer. For example, a value of 4096 would ensure that the buffer is aligned on a 4096-byte boundary. This means that the address returned would have the low order 12 bits set to zero.
This parameter must be a power of 2.
Return Values Argument Explanation
  NOERROR The buffer is returned.
  VD_E_MEMORY An out of memory condition has occurred.
  VD_E_INVALID A parameter was invalid.
Remarks None