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 (
|
|
| 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 | |