Fixed some comments and types.

NTwain/Data/Types.cs

@@ -114,7 +114,6 @@ namespace NTwain.Data
         CallbackDelegate _callBackProc;
         TW_UINT32 _refCon;
         TW_INT16 _message;
-
     }
 
     [StructLayout(LayoutKind.Sequential, Pack = 2)]
@@ -538,7 +537,7 @@ namespace NTwain.Data
     }
 
     [StructLayout(LayoutKind.Sequential, Pack = 2)]
-    partial struct TWFilterDescriptor
+    partial class TWFilterDescriptor
     {
         TW_UINT32 _size;
         TW_UINT32 _hueStart;

NTwain/Data/TypesExtended.cs

@@ -468,13 +468,15 @@ namespace NTwain.Data
         /// </summary>
         public TWDecodeFunction[] Decode { get { return _decode; } set { _decode = value; } }
         /// <summary>
-        /// 3x3 matrix that specifies how channels are mixed in
+        /// 3x3 matrix that specifies how channels are mixed in.
         /// </summary>
         public TWFix32[][] Mix { get { return _mix; } set { _mix = value; } }
     }
 
     /// <summary>
-    /// Container for a collection of values.
+    /// Stores a group of associated individual values for a capability.
+    /// The values need have no relationship to one another aside from 
+    /// being used to describe the same "value" of the capability
     /// </summary>
     public partial class TWArray
     {
@@ -514,21 +516,67 @@ namespace NTwain.Data
         public string Name { get { return _name; } }
     }
 
+    /// <summary>
+    /// Used in Callback mechanism for sending messages from the Source to the Application.
+    /// Applications version 2.2 or higher must use <see cref="TWCallback2"/>.
+    /// </summary>
     partial class TWCallback
     {
-        public TWCallback() { }
+        /// <summary>
+        /// Initializes a new instance of the <see cref="TWCallback"/> class.
+        /// </summary>
+        /// <param name="callback">The callback function’s entry point.</param>
         public TWCallback(CallbackDelegate callback)
         {
             _callBackProc = callback;
         }
+
+        /// <summary>
+        /// An application defined reference constant.
+        /// </summary>
+        /// <value>
+        /// The reference constant.
+        /// </value>
+        public uint RefCon { get { return _refCon; } set { _refCon = value; } }
+
+        /// <summary>
+        /// Initialized to any valid DG_CONTROL / DAT_NULL message.
+        /// </summary>
+        /// <value>
+        /// The message.
+        /// </value>
+        public short Message { get { return _message; } set { _message = value; } }
     }
+    /// <summary>
+    /// Used in the Callback mechanism for sending messages from the Source to the Application.
+    /// </summary>
     partial class TWCallback2
     {
-        public TWCallback2() { }
+        /// <summary>
+        /// Initializes a new instance of the <see cref="TWCallback2"/> class.
+        /// </summary>
+        /// <param name="callback">The callback function’s entry point.</param>
         public TWCallback2(CallbackDelegate callback)
         {
             _callBackProc = callback;
         }
+
+        /// <summary>
+        /// An application defined reference constant. It has a different size on different
+        /// platforms.
+        /// </summary>
+        /// <value>
+        /// The reference constant.
+        /// </value>
+        public UIntPtr RefCon { get { return _refCon; } set { _refCon = value; } }
+
+        /// <summary>
+        /// Initialized to any valid DG_CONTROL / DAT_NULL message.
+        /// </summary>
+        /// <value>
+        /// The message.
+        /// </value>
+        public short Message { get { return _message; } set { _message = value; } }
     }
 
     /// <summary>
@@ -592,16 +640,12 @@ namespace NTwain.Data
         /// </summary>
         public CapabilityId Capability { get { return (CapabilityId)_cap; } set { _cap = (ushort)value; } }
         /// <summary>
-        /// The type of the container structure referenced by hContainer. The container
+        /// The type of the container structure referenced by the pointer internally. The container
         /// will be one of four types: <see cref="TWArray"/>, <see cref="TWEnumeration"/>,
         /// <see cref="TWOneValue"/>, or <see cref="TWRange"/>.
         /// </summary>
         public ContainerType ContainerType { get { return (Values.ContainerType)_conType; } set { _conType = (ushort)value; } }
-        ///// <summary>
+
-        ///// References the container structure where detailed information about the
-        ///// capability is stored.
-        ///// </summary>
-        //IntPtr hContainer;
 
         #endregion
 
@@ -1072,6 +1116,9 @@ namespace NTwain.Data
 
         #region IDisposable Members
 
+        /// <summary>
+        /// Performs application-defined tasks associated with freeing, releasing, or resetting unmanaged resources.
+        /// </summary>
         public void Dispose()
         {
             if (_hContainer != IntPtr.Zero)
@@ -1082,6 +1129,9 @@ namespace NTwain.Data
             GC.SuppressFinalize(this);
         }
 
+        /// <summary>
+        /// Finalizes an instance of the <see cref="TWCapability"/> class.
+        /// </summary>
         ~TWCapability()
         {
             if (_hContainer != IntPtr.Zero)
@@ -1234,7 +1284,7 @@ namespace NTwain.Data
         /// Values that specify the CIE 1931 (XYZ space) tri-stimulus value of solid
         /// black ink on the "paper" from which the image was acquired.
         /// </summary>
-        public TWCiePoint WhiteInk { get { return _blackInk; } set { _blackInk = value; } }
+        public TWCiePoint BlackInk { get { return _blackInk; } set { _blackInk = value; } }
         /// <summary>
         /// Optional table look-up values used by the decode function. Samples
         /// are ordered sequentially and end-to-end as A, B, C, L, M, and N.
@@ -1402,10 +1452,8 @@ namespace NTwain.Data
     }
 
     /// <summary>
-    /// Container for a collection of values. The values are ordered from lowest
+    /// An enumeration stores a list of individual values, with one of the items designated as the current
-    /// to highest values, but the step size between each value is probably not uniform. Such a list
+    /// value. There is no required order to the values in the list.
-    /// would be useful to describe the discreet resolutions of a capture device supporting, say, 75, 150,
-    /// 300, 400, and 800 dots per inch.
     /// </summary>
     public partial class TWEnumeration
     {
@@ -1418,12 +1466,12 @@ namespace NTwain.Data
         ///// </summary>
         //public int Count { get { return (int)_numItems; } set { _numItems = (uint)value; } }
         /// <summary>
-        /// The item number, or index (zero-based) into ItemList[], of the "current"
+        /// The item number, or index (zero-based) into <see cref="ItemList"/>, of the "current"
         /// value for the capability.
         /// </summary>
         public int CurrentIndex { get { return (int)_currentIndex; } set { _currentIndex = (uint)value; } }
         /// <summary>
-        /// The item number, or index (zero-based) into ItemList[], of the "power-on"
+        /// The item number, or index (zero-based) into <see cref="ItemList"/>, of the "power-on"
         /// value for the capability.
         /// </summary>
         public int DefaultIndex { get { return (int)_defaultIndex; } set { _defaultIndex = (uint)value; } }
@@ -1449,9 +1497,8 @@ namespace NTwain.Data
 
 
     /// <summary>
-    /// Used to pass application events/messages from the application to the Source. The Source is
+    /// Used on Windows and Macintosh pre OS X to pass application events/messages from the
-    /// responsible for examining the event/message, deciding if it belongs to the Source, and
+    /// application to the Source.
-    /// returning an appropriate return code to indicate whether or not the Source owns the event/message.
     /// </summary>
     public partial class TWEvent
     {
@@ -1464,13 +1511,16 @@ namespace NTwain.Data
         public IntPtr pEvent { get { return _pEvent; } set { _pEvent = value; } }
         /// <summary>
         /// Any message the Source needs to send to the application in
-        /// response to processing the event/message.
+        /// response to processing the event/message. The messages currently defined for
+        /// this purpose are <see cref="Message.Null"/>, <see cref="Message.XferReady"/> 
+        /// and <see cref="Message.CloseDSReq"/>.
         /// </summary>
         public Message TWMessage { get { return (Message)_tWMessage; } }
     }
 
     /// <summary>
-    /// This structure is used to pass specific information between the data source and the application.
+    /// This structure is used to pass specific information between the data source and the application
+    /// through <see cref="TWExtImageInfo"/>.
     /// </summary>
     public partial struct TWInfo
     {
@@ -1483,14 +1533,20 @@ namespace NTwain.Data
         /// </summary>
         public ItemType ItemType { get { return (ItemType)_itemType; } set { _itemType = (ushort)value; } }
         /// <summary>
-        /// Number of items for this field.
+        /// Number of items.
         /// </summary>
         public ushort NumItems { get { return _numItems; } set { _numItems = value; } }
 
+        /// <summary>
+        /// This is the return code of availability of data for extended image attribute requested.
+        /// </summary>
+        /// <value>
+        /// The return code.
+        /// </value>
         public ReturnCode ReturnCode { get { return (ReturnCode)_returnCode; } set { _returnCode = (ushort)value; } }
 
         /// <summary>
-        /// The TW_Info.Item field contains either data or a handle to data. The field
+        /// Contains either data or a handle to data. The field
         /// contains data if the total amount of data is less than or equal to four bytes. The
         /// field contains a handle of the total amount of data is more than four bytes.
         /// The amount of data is determined by multiplying NumItems times
@@ -1529,7 +1585,6 @@ namespace NTwain.Data
     /// </summary>
     public partial class TWFileSystem
     {
-        /* DG_CONTROL / DAT_FILESYSTEM / MSG_xxxx fields     */
         /// <summary>
         /// The name of the input or source file.
         /// </summary>
@@ -1550,12 +1605,24 @@ namespace NTwain.Data
         /// sub-directories in the directory being copied.
         /// </summary>
         public short Recursive { get { return _recursive; } set { _recursive = value; } }
-        public ushort Subdirectories { get { return _subdirectories; } set { _subdirectories = value; } }
+        public bool Subdirectories { get { return _subdirectories == TwainConst.True; } }
 
-        /* DG_CONTROL / DAT_FILESYSTEM / MSG_GETInfo fields  */
+        /// <summary>
+        /// Gets the type of the file.
+        /// </summary>
+        /// <value>
+        /// The type of the file.
+        /// </value>
         public FileType FileType { get { return (FileType)_fileType; } set { _fileType = (int)value; } }
         public uint FileSystemType { get { return _fileSystemType; } set { _fileSystemType = value; } }
 
+        /// <summary>
+        /// If <see cref="NTwain.Values.FileType.Directory"/>, total size of media in bytes.
+        /// If <see cref="NTwain.Values.FileType.Image"/>, size of image in bytes.
+        /// </summary>
+        /// <value>
+        /// The size.
+        /// </value>
         public uint Size { get { return _size; } set { _size = value; } }
         /// <summary>
         /// The create date of the file, in the form "YYYY/MM/DD
@@ -1565,7 +1632,7 @@ namespace NTwain.Data
         /// </summary>
         public string CreateTimeDate { get { return _createTimeDate; } set { _createTimeDate = value; } }
         /// <summary>
-        /// Last date the file was modified. Same format as CreateTimeDate.
+        /// Last date the file was modified. Same format as <see cref="CreateTimeDate"/>.
         /// </summary>
         public string ModifiedTimeDate { get { return _modifiedTimeDate; } set { _modifiedTimeDate = value; } }
         /// <summary>
@@ -1579,7 +1646,19 @@ namespace NTwain.Data
         /// approximate number of images that the Device has room for.
         /// </summary>
         public int NewImageSize { get { return _newImageSize; } set { _newImageSize = value; } }
+        /// <summary>
+        /// If applicable, return the number of <see cref="NTwain.Values.FileType.Image"/> files on the file system including those in all sub-directories.
+        /// </summary>
+        /// <value>
+        /// The number of files.
+        /// </value>
         public uint NumberOfFiles { get { return _numberOfFiles; } set { _numberOfFiles = value; } }
+        /// <summary>
+        /// The number of audio snippets associated with a file of type <see cref="NTwain.Values.FileType.Image"/>.
+        /// </summary>
+        /// <value>
+        /// The number of snippets.
+        /// </value>
         public uint NumberOfSnippets { get { return _numberOfSnippets; } set { _numberOfSnippets = value; } }
         /// <summary>
         /// Used to group cameras (ex: front/rear bitonal, front/rear grayscale...).
@@ -1782,6 +1861,16 @@ namespace NTwain.Data
         //{
         //	return Create(supportedGroups);
         //}
+        /// <summary>
+        /// Creates a <see cref="TWIdentity"/> specified values.
+        /// </summary>
+        /// <param name="supportedGroups">The supported groups.</param>
+        /// <param name="version">The version.</param>
+        /// <param name="manufacturer">The manufacturer.</param>
+        /// <param name="productFamily">The product family.</param>
+        /// <param name="productName">Name of the product.</param>
+        /// <param name="productDescription">The product description.</param>
+        /// <returns></returns>
         public static TWIdentity Create(DataGroups supportedGroups, Version version,
             string manufacturer, string productFamily, string productName, string productDescription)
         {
@@ -1997,7 +2086,7 @@ namespace NTwain.Data
         /// </summary>
         public uint BytesWritten { get { return _bytesWritten; } set { _bytesWritten = value; } }
         /// <summary>
-        /// A structure of type TW_MEMORY describing who must dispose of the
+        /// A structure of type <see cref="TWMemory"/> describing who must dispose of the
         /// buffer, the actual size of the buffer, in bytes, and where the buffer is
         /// located in memory.
         /// </summary>
@@ -2140,6 +2229,9 @@ namespace NTwain.Data
     /// </summary>
     partial class TWPendingXfers
     {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="TWPendingXfers"/> class.
+        /// </summary>
         public TWPendingXfers()
         {
             _count = TwainConst.DontCare16;
@@ -2153,10 +2245,10 @@ namespace NTwain.Data
         public int Count { get { return _count == TwainConst.DontCare16 ? -1 : (int)_count; } }
         /// <summary>
         /// The application should check this field if the CapJobControl is set to other
-        /// than None. If this is not false, the application should expect more data
+        /// than None. If this is not 0, the application should expect more data
         /// from the driver according to CapJobControl settings.
         /// </summary>
-        public bool EndOfJob { get { return _eOJ == 0; } }
+        public uint EndOfJob { get { return _eOJ; } }
     }
 
 
@@ -2198,8 +2290,8 @@ namespace NTwain.Data
     /// <summary>
     /// This structure is used by the application to specify a set of mapping values to be applied to RGB
     /// color data. Use this structure for RGB data whose bit depth is up to, and including, 8-bits.
-    /// The number of elements in the array is determined by <see cref="TWImageInfo.BItsPerPixel"/>—the number of
+    /// The number of elements in the array is determined by <see cref="TWImageInfo.BitsPerPixel"/>—the number of
-    /// elements is 2 raised to the power of <see cref="TWImageInfo.BItsPerPixel"/>.
+    /// elements is 2 raised to the power of <see cref="TWImageInfo.BitsPerPixel"/>.
     /// </summary>
     public partial class TWRgbResponse
     {
@@ -2225,11 +2317,11 @@ namespace NTwain.Data
         /// </summary>
         public FileFormat Format { get { return (FileFormat)_format; } set { _format = (ushort)value; } }
 
-        ///// <summary>
+        /// <summary>
-        ///// The volume reference number for the file. This applies to Macintosh only. On
+        /// The volume reference number for the file. This applies to Macintosh only. On
-        ///// Windows, fill the field with -1.
+        /// Windows, fill the field with -1.
-        ///// </summary>
+        /// </summary>
-        //public short VRefNum { get { return _vRefNum; } set { _vRefNum = value; } }
+        public short VRefNum { get { return _vRefNum; } set { _vRefNum = value; } }
     }
 
 
@@ -2344,6 +2436,9 @@ namespace NTwain.Data
     /// </summary>
     partial class TWEntryPoint
     {
+        /// <summary>
+        /// Initializes a new instance of the <see cref="TWEntryPoint"/> class.
+        /// </summary>
         [EnvironmentPermissionAttribute(SecurityAction.LinkDemand)]
         public TWEntryPoint()
         {
@@ -2370,23 +2465,101 @@ namespace NTwain.Data
     }
 
 
-    public partial struct TWFilterDescriptor
+    /// <summary>
+    /// The range of colors specified by this structure is replaced with Replacement grayscale value in the
+    /// binary image. The color is specified in HSV color space.
+    /// </summary>
+    public partial class TWFilterDescriptor
     {
-        public UInt32 Size { get { return _size; } set { _size = value; } }
+        /// <summary>
-        public UInt32 HueStart { get { return _hueStart; } set { _hueStart = value; } }
+        /// Initializes a new instance of the <see cref="TWFilterDescriptor"/> struct.
-        public UInt32 HueEnd { get { return _hueEnd; } set { _hueEnd = value; } }
+        /// </summary>
-        public UInt32 SaturationStart { get { return _saturationStart; } set { _saturationStart = value; } }
+        public TWFilterDescriptor()
-        public UInt32 SaturationEnd { get { return _saturationEnd; } set { _saturationEnd = value; } }
+        {
-        public UInt32 ValueStart { get { return _valueStart; } set { _valueStart = value; } }
+            _size = (uint)Marshal.SizeOf(this);
-        public UInt32 ValueEnd { get { return _valueEnd; } set { _valueEnd = value; } }
+        }
-        public UInt32 Replacement { get { return _replacement; } set { _replacement = value; } }
+
+        /// <summary>
+        /// Size of this structure in bytes.
+        /// </summary>
+        /// <value>
+        /// The size.
+        /// </value>
+        public uint Size { get { return _size; } set { _size = value; } }
+        /// <summary>
+        /// Hue starting number. Valid values 0 to 3600 (0° to 360°).
+        /// </summary>
+        public uint HueStart { get { return _hueStart; } set { _hueStart = value; } }
+        /// <summary>
+        /// Hue ending number. Valid values 0 to 3600 (0° to 360°).
+        /// </summary>
+        public uint HueEnd { get { return _hueEnd; } set { _hueEnd = value; } }
+        /// <summary>
+        /// Saturation starting number. Valid values 0 to 1000 (0% to 100%).
+        /// </summary>
+        public uint SaturationStart { get { return _saturationStart; } set { _saturationStart = value; } }
+        /// <summary>
+        /// Saturation ending number. Valid values 0 to 1000 (0% to 100%).
+        /// </summary>
+        public uint SaturationEnd { get { return _saturationEnd; } set { _saturationEnd = value; } }
+        /// <summary>
+        /// Luminosity starting number. Valid values 0 to 1000 (0% to 100%).
+        /// </summary>
+        public uint ValueStart { get { return _valueStart; } set { _valueStart = value; } }
+        /// <summary>
+        /// Luminosity ending number. Valid values 0 to 1000 (0% to 100%).
+        /// </summary>
+        public uint ValueEnd { get { return _valueEnd; } set { _valueEnd = value; } }
+        /// <summary>
+        /// Replacement grayscale value. Valid values 0 to (2^32)–1 (Maximum value
+        /// depends on grayscale bit depth).
+        /// </summary>
+        public uint Replacement { get { return _replacement; } set { _replacement = value; } }
     }
+
+    /// <summary>
+    /// Specifies the filter to be applied during image acquisition. More than one descriptor can be
+    /// specified. All descriptors are applied with an OR statement.
+    /// </summary>
     public partial class TWFilter
     {
-        public UInt32 Size { get { return _size; } set { _size = value; } }
+        /// <summary>
-        public UInt32 DescriptorCount { get { return _descriptorCount; } set { _descriptorCount = value; } }
+        /// Initializes a new instance of the <see cref="TWFilter"/> class.
-        public UInt32 MaxDescriptorCount { get { return _maxDescriptorCount; } set { _maxDescriptorCount = value; } }
+        /// </summary>
-        public UInt32 Condition { get { return _condition; } set { _condition = value; } }
+        public TWFilter()
+        {
+            _size = (uint)Marshal.SizeOf(this);
+        }
+
+        /// <summary>
+        /// Number of descriptors in hDescriptors array.
+        /// </summary>
+        /// <value>
+        /// The descriptor count.
+        /// </value>
+        public uint DescriptorCount { get { return _descriptorCount; } set { _descriptorCount = value; } }
+        /// <summary>
+        /// Maximum possible descriptors. Valid only for GET and GETDEFAULT operations.
+        /// </summary>
+        /// <value>
+        /// The maximum descriptor count.
+        /// </value>
+        public uint MaxDescriptorCount { get { return _maxDescriptorCount; } set { _maxDescriptorCount = value; } }
+        /// <summary>
+        /// If the value is 0 filter will check if current pixel color is inside the area
+        /// specified by the descriptor. If the value is 1 it will check if it is outside
+        /// of this area.
+        /// </summary>
+        /// <value>
+        /// The condition.
+        /// </value>
+        public uint Condition { get { return _condition; } set { _condition = value; } }
+        /// <summary>
+        /// Handle to array of <see cref="TWFilterDescriptor"/>.
+        /// </summary>
+        /// <value>
+        /// The descriptors.
+        /// </value>
         public IntPtr hDescriptors { get { return _hDescriptors; } set { _hDescriptors = value; } }
     }
 

NTwain/MemoryManager.cs

@@ -9,8 +9,10 @@ namespace NTwain
 {
     /// <summary>
     /// Provides methods for managing memory on data exchanged with twain sources.
+    /// This should only be used after the DSM has been opened in <see cref="TwainSession"/>
+    /// via <see cref="TwainSession.OpenManager"/>.
     /// </summary>
-    class MemoryManager
+    public class MemoryManager
     {
         /// <summary>
         /// Gets the global <see cref="MemoryManager"/> instance.
@@ -30,6 +32,11 @@ namespace NTwain
 
         TWEntryPoint _twain2Entry;
 
+        /// <summary>
+        /// Function to allocate memory. Calls to this must be coupled with <see cref="MemFree"/> later.
+        /// </summary>
+        /// <param name="size">The size in bytes.</param>
+        /// <returns>Handle to the allocated memory.</returns>
         public IntPtr MemAllocate(uint size)
         {
             if (_twain2Entry != null && _twain2Entry.AllocateFunction != null)
@@ -42,6 +49,11 @@ namespace NTwain
                 return GlobalAlloc(0x0040, new UIntPtr(size));
             }
         }
+
+        /// <summary>
+        /// Function to free memory. 
+        /// </summary>
+        /// <param name="handle">The handle from <see cref="MemAllocate"/>.</param>
         public void MemFree(IntPtr handle)
         {
             if (_twain2Entry != null && _twain2Entry.FreeFunction != null)
@@ -53,6 +65,12 @@ namespace NTwain
                 GlobalFree(handle);
             }
         }
+
+        /// <summary>
+        /// Function to lock some memory. Calls to this must be coupled with <see cref="MemUnlock"/> later.
+        /// </summary>
+        /// <param name="handle">The handle to allocated memory.</param>
+        /// <returns>Handle to the lock.</returns>
         public IntPtr MemLock(IntPtr handle)
         {
             if (_twain2Entry != null && _twain2Entry.LockFunction != null)
@@ -64,6 +82,11 @@ namespace NTwain
                 return GlobalLock(handle);
             }
         }
+
+        /// <summary>
+        /// Function to unlock a previously locked memory region.
+        /// </summary>
+        /// <param name="handle">The handle from <see cref="MemLock"/>.</param>
         public void MemUnlock(IntPtr handle)
         {
             if (_twain2Entry != null && _twain2Entry.UnlockFunction != null)
@@ -82,14 +105,14 @@ namespace NTwain
         static extern IntPtr GlobalAlloc(uint uFlags, UIntPtr dwBytes);
 
         [DllImport("kernel32", SetLastError = true, ExactSpelling = true)]
-        public static extern IntPtr GlobalFree(IntPtr hMem);
+        static extern IntPtr GlobalFree(IntPtr hMem);
 
         [DllImport("kernel32", SetLastError = true, ExactSpelling = true)]
-        public static extern IntPtr GlobalLock(IntPtr handle);
+        static extern IntPtr GlobalLock(IntPtr handle);
 
         [DllImport("kernel32", SetLastError = true, ExactSpelling = true)]
         [return: MarshalAs(UnmanagedType.Bool)]
-        public static extern bool GlobalUnlock(IntPtr handle);
+        static extern bool GlobalUnlock(IntPtr handle);
 
         #endregion
     }

NTwain/Properties/VersionInfo.cs

@@ -14,6 +14,6 @@ namespace NTwain
         // keep this same in majors releases
         public const string Release = "0.8.0.0";
         // change this for each nuget release
-        public const string Build = "0.8.1";
+        public const string Build = "0.8.2";
     }
 }

NTwain/TransferReadyEventArgs.cs

@@ -24,7 +24,7 @@ namespace NTwain
             IList<Compression> supportedCompressions, Compression currentCompression, bool canDoFileXfer, TWImageInfo imageInfo)
         {
             PendingCount = pending.Count;
-            EndOfJob = pending.EndOfJob;
+            EndOfJob = pending.EndOfJob == 0;
             _imageCompression = currentCompression;
             SupportedCompressions = supportedCompressions;
             _imageFormat = currentFormat;

NTwain/Triplets/DGAudio/DGAudio.AudioFileXfer.cs

@@ -3,6 +3,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.AudioFileXfer"/>.
+    /// </summary>
 	sealed class AudioFileXfer : OpBase
 	{
         internal AudioFileXfer(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGAudio/DGAudio.AudioInfo.cs

@@ -3,6 +3,9 @@ using NTwain.Values;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.AudioInfo"/>.
+    /// </summary>
 	public sealed class AudioInfo : OpBase
 	{
 		internal AudioInfo(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGAudio/DGAudio.AudioNativeXfer.cs

@@ -3,6 +3,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.AudioNativeXfer"/>.
+    /// </summary>
 	sealed class AudioNativeXfer : OpBase
 	{
 		internal AudioNativeXfer(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGAudio/DGAudio.cs

@@ -1,8 +1,9 @@
-using System;
+using NTwain.Values;
+using System;
 namespace NTwain.Triplets
 {
-	/// <summary>
+    /// <summary>
-	/// Class for grouping triplet operations under the Audio data group.
+    /// Represents <see cref="DataGroups.Audio"/>.
 	/// </summary>
 	public sealed class DGAudio
 	{

NTwain/Triplets/DGControl/DGControl.Capability.cs

@@ -4,6 +4,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.Capability"/>.
+    /// </summary>
 	public sealed class Capability : OpBase
 	{
 		internal Capability(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGControl/DGControl.CustomDSData.cs

@@ -4,6 +4,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.CustomDSData"/>.
+    /// </summary>
 	public sealed class CustomDSData : OpBase
 	{
 		internal CustomDSData(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGControl/DGControl.DeviceEvent.cs

@@ -4,6 +4,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.DeviceEvent"/>.
+    /// </summary>
 	public sealed class DeviceEvent : OpBase
 	{
 		internal DeviceEvent(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGControl/DGControl.EntryPoint.cs

@@ -4,6 +4,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.EntryPoint"/>.
+    /// </summary>
 	sealed class EntryPoint : OpBase
 	{
 		internal EntryPoint(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGControl/DGControl.FileSystem.cs

@@ -4,6 +4,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.FileSystem"/>.
+    /// </summary>
 	public sealed class FileSystem : OpBase
 	{
 		internal FileSystem(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGControl/DGControl.Identity.cs

@@ -4,6 +4,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.Identity"/>.
+    /// </summary>
 	public sealed class Identity : OpBase
 	{
 		internal Identity(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGControl/DGControl.Parent.cs

@@ -5,6 +5,9 @@ using System.Runtime.InteropServices;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.Parent"/>.
+    /// </summary>
     sealed class Parent : OpBase
     {
         internal Parent(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGControl/DGControl.PassThru.cs

@@ -4,6 +4,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.PassThru"/>.
+    /// </summary>
 	public sealed class PassThru : OpBase
 	{
 		internal PassThru(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGControl/DGControl.PendingXfers.cs

@@ -4,6 +4,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.PendingXfers"/>.
+    /// </summary>
 	sealed class PendingXfers : OpBase
 	{
 		internal PendingXfers(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGControl/DGControl.SetupFileXfer.cs

@@ -4,6 +4,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.SetupFileXfer"/>.
+    /// </summary>
 	public sealed class SetupFileXfer : OpBase
 	{
 		internal SetupFileXfer(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGControl/DGControl.SetupMemXfer.cs

@@ -4,6 +4,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.SetupMemXfer"/>.
+    /// </summary>
 	public sealed class SetupMemXfer : OpBase
 	{
 		internal SetupMemXfer(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGControl/DGControl.Status.cs

@@ -4,6 +4,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.Status"/>.
+    /// </summary>
 	public sealed class Status : OpBase
 	{
 		internal Status(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGControl/DGControl.StatusUtf8.cs

@@ -4,6 +4,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.StatusUtf8"/>.
+    /// </summary>
 	public sealed class StatusUtf8 : OpBase
 	{
 		internal StatusUtf8(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGControl/DGControl.UserInterface.cs

@@ -4,6 +4,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.UserInterface"/>.
+    /// </summary>
     sealed class UserInterface : OpBase
     {
         internal UserInterface(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGControl/DGControl.XferGroup.cs

@@ -4,6 +4,9 @@ using NTwain.Values;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.XferGroup"/>.
+    /// </summary>
 	public sealed class XferGroup : OpBase
 	{
 		internal XferGroup(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGControl/DGControl.cs

@@ -1,8 +1,9 @@
-using System;
+using NTwain.Values;
+using System;
 namespace NTwain.Triplets
 {
-	/// <summary>
+    /// <summary>
-	/// Class for grouping triplet operations under the Control data group.
+    /// Represents <see cref="DataGroups.Control"/>.
 	/// </summary>
 	public sealed class DGControl
 	{

NTwain/Triplets/DGImage/DGImage.CieColor.cs

@@ -4,6 +4,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.CieColor"/>.
+    /// </summary>
 	public sealed class CieColor : OpBase
 	{
 		internal CieColor(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGImage/DGImage.ExtImageInfo.cs

@@ -4,6 +4,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.ExtImageInfo"/>.
+    /// </summary>
 	public sealed class ExtImageInfo : OpBase
 	{
 		internal ExtImageInfo(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGImage/DGImage.Filter.cs

@@ -4,6 +4,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.Filter"/>.
+    /// </summary>
 	public sealed class Filter : OpBase
 	{
         internal Filter(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGImage/DGImage.GrayResponse.cs

@@ -4,6 +4,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.GrayResponse"/>.
+    /// </summary>
 	public sealed class GrayResponse : OpBase
 	{
 		internal GrayResponse(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGImage/DGImage.IccProfile.cs

@@ -4,6 +4,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.IccProfile"/>.
+    /// </summary>
 	public sealed class IccProfile : OpBase
 	{
 		internal IccProfile(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGImage/DGImage.ImageFileXfer.cs

@@ -4,6 +4,9 @@ using NTwain.Values;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.ImageFileXfer"/>.
+    /// </summary>
 	sealed class ImageFileXfer : OpBase
 	{
 		internal ImageFileXfer(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGImage/DGImage.ImageInfo.cs

@@ -4,6 +4,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.ImageInfo"/>.
+    /// </summary>
 	public sealed class ImageInfo : OpBase
 	{
 		internal ImageInfo(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGImage/DGImage.ImageLayout.cs

@@ -4,6 +4,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.ImageLayout"/>.
+    /// </summary>
 	public sealed class ImageLayout : OpBase
 	{
 		internal ImageLayout(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGImage/DGImage.JpegCompression.cs

@@ -4,6 +4,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.JpegCompression"/>.
+    /// </summary>
 	public sealed class JpegCompression : OpBase
 	{
 		internal JpegCompression(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGImage/DGImage.Palette8.cs

@@ -4,6 +4,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.Palette8"/>.
+    /// </summary>
 	public sealed class Palette8 : OpBase
 	{
 		internal Palette8(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGImage/DGImage.RgbResponse.cs

@@ -4,6 +4,9 @@ using System;
 
 namespace NTwain.Triplets
 {
+    /// <summary>
+    /// Represents <see cref="DataArgumentType.RgbResponse"/>.
+    /// </summary>
 	public sealed class RgbResponse : OpBase
 	{
 		internal RgbResponse(ITwainSessionInternal session) : base(session) { }

NTwain/Triplets/DGImage/DGImage.cs

@@ -1,8 +1,9 @@
-using System;
+using NTwain.Values;
+using System;
 namespace NTwain.Triplets
 {
-	/// <summary>
+    /// <summary>
-	/// Class for grouping triplet operations under the Image data group.
+    /// Represents <see cref="DataGroups.Image"/>.
 	/// </summary>
 	public sealed class DGImage
 	{