Share via


NTMS_PMIDINFORMATION Structure

[Removable Storage Manager is no longer available as of Windows 7 and Windows Server 2008 R2.]

The NTMS_PMIDINFORMATION structure defines the properties specific to a physical media object.

Syntax

typedef struct _NTMS_PMIDINFORMATION {
  NTMS_GUID CurrentLibrary;
  NTMS_GUID MediaPool;
  NTMS_GUID Location;
  DWORD     LocationType;
  NTMS_GUID HomeSlot;
  NTMS_GUID MediaType;
  TCHAR     szBarCode[NTMS_BARCODE_LENGTH];
  DWORD     BarCodeState;
  TCHAR     szSequenceNumber[NTMS_SEQUENCE_LENGTH];
  DWORD     MediaState;
  DWORD     dwNumberOfPartitions;
  DWORD     dwMediaTypeCode;
  DWORD     dwDensityCode;
  NTMS_GUID MountedPartition;
} NTMS_PMIDINFORMATION;

Members

  • CurrentLibrary
    Unique ID of the library in which the media is contained.

  • MediaPool
    Unique ID of the media pool to which the media is assigned.

  • Location
    Unique ID of the physical location object for the media.

  • LocationType
    Current location type of a piece of physical media. The value of this member can be set to NTMS_STORAGESLOT, NTMS_DRIVE, NTMS_IEPORT. (Offline media are in slots.)

  • HomeSlot
    Unique ID of the library storage slot in which media is stored.

  • MediaType
    Unique ID of a media type object.

  • szBarCode
    String that matches the bar-code value on a bar-code label of a piece of physical media.

  • BarCodeState
    Current state of the bar code. This can be one of the following values.

    Value Meaning
    NTMS_BARCODESTATE_OK

    The media has a bar code and it is readable.

    NTMS_BARCODESTATE_UNREADABLE

    The media either does not have a bar code or the bar code is unreadable.

     

  • szSequenceNumber
    Sequential number assigned to the specified medium as a human-readable value that must be transcribed by a user on the medium so that the medium can be located in an offline library.

  • MediaState
    Current state for the piece of physical media. This can be one of the following values.

    Value Meaning
    NTMS_MEDIASTATE_IDLE

    The media is in a slot in the library, in a drive dismounted, or in an offline library.

    NTMS_MEDIASTATE_INUSE

    The media is marked as in use as soon as a request for an operation is successfully made to RSM.

    NTMS_MEDIASTATE_LOADED

    The state of the media when RSM has determined that the media is available for reading and writing.

    NTMS_MEDIASTATE_MOUNTED

    The state of a piece of physical media when the media is placed in a drive.

    NTMS_MEDIASTATE_OP_ERROR

    The physical media is in an error state that is recoverable. No operator intervention is required.

    NTMS_MEDIASTATE_UNLOADED

    The state of the media when it is ready to be removed from a drive. The drive state, DISMOUNTABLE, also indicates that a drive can be removed at any time.

    NTMS_MEDIASTATE_OPREQ

    Media is waiting for operator request.

     

  • dwNumberOfPartitions
    Number of sides on the medium.

  • dwMediaTypeCode
    SCSI media type code.

  • dwDensityCode
    SCSI density code.

  • MountedPartition
    Globally unique ID of the side of the media that is currently mounted.

Remarks

The NTMS_PMIDINFORMATION structure is included in the NTMS_OBJECTINFORMATION structure.

Requirements

Minimum supported client

Windows 2000 Professional

Minimum supported server

Windows 2000 Server

End of client support

Windows Vista

End of server support

Windows Server 2008

Header

Ntmsapi.h

See Also

NTMS_OBJECTINFORMATION

 

 

Send comments about this topic to Microsoft

Build date: 6/9/2011