IMAPI_FORMAT2_DATA_MEDIA_STATE enumeration

Defines values for the possible media states.

Syntax


typedef enum _IMAPI_FORMAT2_DATA_MEDIA_STATE { 
  IMAPI_FORMAT2_DATA_MEDIA_STATE_UNKNOWN             = 0,
  IMAPI_FORMAT2_DATA_MEDIA_STATE_INFORMATIONAL_MASK  = 0xf,
  IMAPI_FORMAT2_DATA_MEDIA_STATE_UNSUPPORTED_MASK    = 0xfc00,
  IMAPI_FORMAT2_DATA_MEDIA_STATE_OVERWRITE_ONLY      = 0x1,
  IMAPI_FORMAT2_DATA_MEDIA_STATE_RANDOMLY_WRITABLE   = 0x1,
  IMAPI_FORMAT2_DATA_MEDIA_STATE_BLANK               = 0x2,
  IMAPI_FORMAT2_DATA_MEDIA_STATE_APPENDABLE          = 0x4,
  IMAPI_FORMAT2_DATA_MEDIA_STATE_FINAL_SESSION       = 0x8,
  IMAPI_FORMAT2_DATA_MEDIA_STATE_DAMAGED             = 0x400,
  IMAPI_FORMAT2_DATA_MEDIA_STATE_ERASE_REQUIRED      = 0x800,
  IMAPI_FORMAT2_DATA_MEDIA_STATE_NON_EMPTY_SESSION   = 0x1000,
  IMAPI_FORMAT2_DATA_MEDIA_STATE_WRITE_PROTECTED     = 0x2000,
  IMAPI_FORMAT2_DATA_MEDIA_STATE_FINALIZED           = 0x4000,
  IMAPI_FORMAT2_DATA_MEDIA_STATE_UNSUPPORTED_MEDIA   = 0x8000
} IMAPI_FORMAT2_DATA_MEDIA_STATE, *PIMAPI_FORMAT2_DATA_MEDIA_STATE;

Constants

IMAPI_FORMAT2_DATA_MEDIA_STATE_UNKNOWN

Indicates that the interface does not know the media state.

IMAPI_FORMAT2_DATA_MEDIA_STATE_INFORMATIONAL_MASK

Reports information (but not errors) about the media state.

IMAPI_FORMAT2_DATA_MEDIA_STATE_UNSUPPORTED_MASK

Reports an unsupported media state.

IMAPI_FORMAT2_DATA_MEDIA_STATE_OVERWRITE_ONLY

Write operations can occur on used portions of the disc.

IMAPI_FORMAT2_DATA_MEDIA_STATE_RANDOMLY_WRITABLE

Media is randomly writable. This indicates that a single session can be written to this disc.

Note  This value is deprecated and superseded by IMAPI_FORMAT2_DATA_MEDIA_STATE_OVERWRITE_ONLY.

IMAPI_FORMAT2_DATA_MEDIA_STATE_BLANK

Media has never been used, or has been erased.

IMAPI_FORMAT2_DATA_MEDIA_STATE_APPENDABLE

Media is appendable (supports multiple sessions).

IMAPI_FORMAT2_DATA_MEDIA_STATE_FINAL_SESSION

Media can have only one additional session added to it, or the media does not support multiple sessions.

IMAPI_FORMAT2_DATA_MEDIA_STATE_DAMAGED

Media is not usable by this interface. The media might require an erase or other recovery.

IMAPI_FORMAT2_DATA_MEDIA_STATE_ERASE_REQUIRED

Media must be erased prior to use by this interface.

IMAPI_FORMAT2_DATA_MEDIA_STATE_NON_EMPTY_SESSION

Media has a partially written last session, which is not supported by this interface.

IMAPI_FORMAT2_DATA_MEDIA_STATE_WRITE_PROTECTED

Media or drive is write-protected.

IMAPI_FORMAT2_DATA_MEDIA_STATE_FINALIZED

Media cannot be written to (finalized).

IMAPI_FORMAT2_DATA_MEDIA_STATE_UNSUPPORTED_MEDIA

Media is not supported by this interface.

Remarks

This enumeration should be treated as a bitmask. Nearly all of the values set one bit set to one and the other bits to zero. Three exceptions to this rule were added: unknown, unsupported media mask, and informational mask. For example, to test for unsupported media, check the value against IMAPI_FORMAT2_DATA_MEDIA_STATE_UNSUPPORTED_MASK.

Requirements

Minimum supported client

Windows Vista, Windows XP with SP2 [desktop apps only]

Minimum supported server

Windows Server 2003 [desktop apps only]

IDL

Imapi2.idl

See also

IDiscFormat2Data::get_CurrentMediaStatus

 

 

Community Additions

ADD
Show:
© 2015 Microsoft