Skip to content

Latest commit

 

History

History
243 lines (185 loc) · 7 KB

ns-ntmsapi-ntms_pmidinformationw.md

File metadata and controls

243 lines (185 loc) · 7 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NS:ntmsapi._NTMS_PMIDINFORMATIONW
NTMS_PMIDINFORMATIONW (ntmsapi.h)
The NTMS_PMIDINFORMATION structure defines the properties specific to a physical media object. (Unicode)
NTMS_BARCODESTATE_OK
NTMS_BARCODESTATE_UNREADABLE
NTMS_MEDIASTATE_IDLE
NTMS_MEDIASTATE_INUSE
NTMS_MEDIASTATE_LOADED
NTMS_MEDIASTATE_MOUNTED
NTMS_MEDIASTATE_OPREQ
NTMS_MEDIASTATE_OP_ERROR
NTMS_MEDIASTATE_UNLOADED
NTMS_PMIDINFORMATION
NTMS_PMIDINFORMATION structure [Files]
NTMS_PMIDINFORMATIONA
NTMS_PMIDINFORMATIONW
_NTMS_PMIDINFORMATIONA
_NTMS_PMIDINFORMATIONW
_zaw_ntms_pmidinformation
base.ntms_pmidinformation
fs.ntms_pmidinformation
ntmsapi/NTMS_PMIDINFORMATION
fs\ntms_pmidinformation.htm
fs
9ed46cc9-0b93-44ef-9c33-1e1baadb225f
12/05/2018
NTMS_BARCODESTATE_OK, NTMS_BARCODESTATE_UNREADABLE, NTMS_MEDIASTATE_IDLE, NTMS_MEDIASTATE_INUSE, NTMS_MEDIASTATE_LOADED, NTMS_MEDIASTATE_MOUNTED, NTMS_MEDIASTATE_OPREQ, NTMS_MEDIASTATE_OP_ERROR, NTMS_MEDIASTATE_UNLOADED, NTMS_PMIDINFORMATION, NTMS_PMIDINFORMATION structure [Files], NTMS_PMIDINFORMATIONA, NTMS_PMIDINFORMATIONW, _NTMS_PMIDINFORMATIONA, _NTMS_PMIDINFORMATIONW, _zaw_ntms_pmidinformation, base.ntms_pmidinformation, fs.ntms_pmidinformation, ntmsapi/NTMS_PMIDINFORMATION
ntmsapi.h
Windows
Windows XP [desktop apps only]
Windows Server 2003 [desktop apps only]
Windows
NTMS_PMIDINFORMATIONW
19H1
_NTMS_PMIDINFORMATIONW
ntmsapi/_NTMS_PMIDINFORMATIONW
NTMS_PMIDINFORMATIONW
ntmsapi/NTMS_PMIDINFORMATIONW
c++
APIRef
kbSyntax
HeaderDef
Ntmsapi.h
NTMS_PMIDINFORMATION
NTMS_PMIDINFORMATIONA
NTMS_PMIDINFORMATIONW

NTMS_PMIDINFORMATIONW structure

-description

[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.

-struct-fields

-field CurrentLibrary

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

-field MediaPool

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

-field Location

Unique ID of the physical location object for the media.

-field 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.)

-field MediaType

Unique ID of a media type object.

-field HomeSlot

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

-field szBarCode

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

-field 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.

-field 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.

-field 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.

-field dwNumberOfPartitions

Number of sides on the medium.

-field dwMediaTypeCode

SCSI media type code.

-field dwDensityCode

SCSI density code.

-field 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.

Note

The ntmsapi.h header defines NTMS_PMIDINFORMATION as an alias which automatically selects the ANSI or Unicode version of this function based on the definition of the UNICODE preprocessor constant. Mixing usage of the encoding-neutral alias with code that not encoding-neutral can lead to mismatches that result in compilation or runtime errors. For more information, see Conventions for Function Prototypes.

-see-also

NTMS_OBJECTINFORMATION