This function returns status information for the multi-page image, such as the association type, open mode, as well as others.
Copy Code
|
|
---|---|
AT_ERRCOUNT ACCUAPI IG_mpi_info_get( [IN] HMIGEAR hMIGear, [IN] AT_MODE nMode, [IN/OUT] LPVOID lpData, [IN] DWORD dwSize ); |
Name | Type | Description |
---|---|---|
hMIGear | HMIGEAR | The handle to the allocated multi-page image. |
nMode | AT_MODE | This argument is used to determine the type of information being retrieved. |
lpData | LPVOID | The far pointer to the buffer indicating where to return the allocated data. |
dwSize | DWORD | The size of the buffer. |
Returns the number of ImageGear errors that occurred during this function call. If there are no errors, the return value is IGE_SUCCESS.
All pixel formats supported by ImageGear for C and C++.
MFC Multipage
Copy Code
|
|
---|---|
HMIGEAR hMIGear; /* handle to multi-page image */ AT_ERRCOUNT nErrCount = IGE_SUCCESS; /* will hold returned error count */ HIGEAR hIGear; /* handle of an image */ AT_MODE nAType; CHAR FileName[_MAX_PATH]; ... /* initialize of multi-page image and assign it with external file */ nErrCount = IG_mpi_info_get( hMIGear, IG_MP_ASSOCIATION_TYPE , &nAType, sizeof(nAType) ); if( nAType== IG_MP_ASSOCIATE_FILE ) { IG_mpi_info_get( hMIGear, IG_MP_FILE_NAME, FileName, sizeof(FileName) ); } |
The value of the parameters depends on nMode. The following table lists the possible combinations:
AT_MODE Constants | Type of Third Argument | dwSize | Description |
---|---|---|---|
IG_MP_ASSOCIATION_TYPE | LPAT_MODE | Sizeof (AT_MODE) |
Returns the association type of the given multi-page image, which can be:
|
IG_MP_OPENMODE | LPAT_MODE | Sizeof(AT_MODE) |
Returns the open mode of the associated file, which can be:
|
IG_MP_FILE_NAME | LPCHAR | Length of the buffer including last 0 byte | Returns the name of the associated file. |
[*]IG_MP_MEM_BUFFER_PTR | LPBYTE | 4 | Returns a pointer to the memory associated with the multi-page image. |
[*]IG_MP_MEM_BUFFER_SIZE | LPDWORD | 4 | Returns the size of the associated memory. |
IG_MP_FORMAT | File format of the multi-page document. One of the enumIGFormats values. | ||
IG_MP_DOCUMENT | Native document associated with the multi-page document. |