Edit

Share via

IMAPI Data Types

  • Article

Specifications for optical media and associated devices define range values for items such as the DVD structure description, disc information description, and feature page size. IMAPI defines the following unsigned long integer (ULONG) types that enforce range value limits. These types are defined strictly for optimal IDL validation of parameters and as a documentation aid to callers regarding the upper limits for certain data transfer operations available.

typedef ULONG ULONG_IMAPI2_DVD_STRUCTURE;
typedef ULONG ULONG_IMAPI2_ADAPTER_DESCRIPTOR;
typedef ULONG ULONG_IMAPI2_DEVICE_DESCRIPTOR;
typedef ULONG ULONG_IMAPI2_DISC_INFORMATION;
typedef ULONG ULONG_IMAPI2_TRACK_INFORMATION;
typedef ULONG ULONG_IMAPI2_FEATURE_PAGE;
typedef ULONG ULONG_IMAPI2_MODE_PAGE;
typedef ULONG ULONG_IMAPI2_ALL_FEATURE_PAGES;
typedef ULONG ULONG_IMAPI2_ALL_PROFILES;
typedef ULONG ULONG_IMAPI2_ALL_MODE_PAGES;
typedef ULONG ULONG_IMAPI2_NONZERO;
typedef ULONG ULONG_IMAPI2_NOT_NEGATIVE;
Data type Description
ULONG_IMAPI2_DVD_STRUCTURE Range: 0,65535 (0,0x0000FFFF)
The DVD structure is limited to 64KB due to a two-byte allocation field.
ULONG_IMAPI2_ADAPTER_DESCRIPTOR Range: 0,268435455 (0,0x0FFFFFFF)
The adapter descriptor is not implicitly limited in size.
ULONG_IMAPI2_DEVICE_DESCRIPTOR Range: 0,268435455 (0,0x0FFFFFFF)
The device descriptor is not implicitly limited in size.
ULONG_IMAPI2_DISC_INFORMATION Range: 0,65538 (0,0x00010002)
Disc information is limited to 64KB plus 2 bytes for the size field.
ULONG_IMAPI2_TRACK_INFORMATION Range: 0,65538 (0,0x00010002)
Track information is limited to 64KB plus 2 bytes for the size field.
ULONG_IMAPI2_FEATURE_PAGE Range: 0,256 (0,0x00000100)
A single feature page is limited to 256 bytes.
ULONG_IMAPI2_MODE_PAGE Range: 0,257 (0,0x00000101)
A single mode page is limited to 257 bytes.
ULONG_IMAPI2_ALL_FEATURE_PAGES Range: 0,65536 (0,0x00010000)
The number of features is limited to a two-byte field.
ULONG_IMAPI2_ALL_PROFILES Range: 0,63 (0,0x0000003F)
The number of profiles for a device is the number of profiles that fit in a single feature. Each profile occupies four bytes. A single feature can hold 252 additional bytes of data, enough to store a maximum of 63 profiles.
ULONG_IMAPI2_ALL_MODE_PAGES Range: 0,32763 (0,0x00007FFB)
Count of the mode pages for a device. The count, via MODE_SENSE10, is limited to a two-byte field.
The mode parameter header is 8 bytes. Each page is at least two bytes. The maximum number of mode pages is 32763: (65535 - 8)/2 rounded down.
ULONG_IMAPI2_NONZERO Range: 1,2147483647 (1,0x7FFFFFFF)
Generic nonzero value that can be used to verify that a value is not zero.
ULONG_IMAPI2_NOT_NEGATIVE Range: 0, 2147483647 (0,0x7FFFFFFF)
A 32-bit integer with non-negative value.

Requirements

Requirement Value
Minimum supported client
 Windows XP [desktop apps only]
Minimum supported server
 Windows Server 2003 [desktop apps only]
Header
Imapi2.h