IMAPI Data Types

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

Minimum supported client

Windows XP [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Imapi2.h

 

 

Community Additions

ADD
Show: