Edit

Share via

IDiaAddressMap::put_imageAlign

  • Article

Sets the image alignment.

Syntax

HRESULT put_imageAlign ( 
   DWORD NewVal
);

Parameters

NewVal

[in] The new image alignment value for the executable.

Return Value

If successful, returns S_OK; otherwise, returns an error code.

Remarks

Images (loaded executables) are aligned to specified memory boundaries. This alignment can be affected by the current system architecture and by compile and link time options. Image alignment is always on byte boundaries. The following image alignment values are valid: 1, 2, 4, 8, 16, 32, and 64 byte boundaries.

The current image alignment can be retrieved with a call to the IDiaAddressMap::get_imageAlign method.

Note

The image is already loaded by the time this method can be called. The put_imageAlign method is typically used when the image has been moved or changed and a new alignment is required.

See also