NTMS_MEDIAPOOLINFORMATION Structure

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

The NTMS_MEDIAPOOLINFORMATION structure defines the properties specific to a media pool object.

Syntax

typedef struct _NTMS_MEDIAPOOLINFORMATION {
  DWORD     PoolType;
  NTMS_GUID MediaType;
  NTMS_GUID Parent;
  DWORD     AllocationPolicy;
  DWORD     DeallocationPolicy;
  DWORD     dwMaxAllocates;
  DWORD     dwNumberOfPhysicalMedia;
  DWORD     dwNumberOfLogicalMedia;
  DWORD     dwNumberOfMediaPools;
} NTMS_MEDIAPOOLINFORMATION;

Members

• PoolType
  NTMS supports the following media pool types.

  Value	Meaning
  NTMS_POOLTYPE_UNKNOWN	Unknown pool type.
  NTMS_POOLTYPE_SCRATCH	Media that is available to other applications.
  NTMS_POOLTYPE_FOREIGN	Media that has been written to and does not contain a recognizable on-media identifier label-type or label ID.
  NTMS_POOLTYPE_IMPORT	Media that has been written to, has a recognizable on-media identifier label type but an unrecognizable label ID.
  NTMS_POOLTYPE_APPLICATION	Media pool created by an application. One or more application media pools can be created per system.

   

• MediaType
  Single media type that makes up each media pool.

• Parent
  Parent media pool or NULL.

• AllocationPolicy
  Bit field indicating action at allocation time. This member is writable. This can be the following value.

  Value	Meaning
  NTMS_ALLOCATE_FROMSCRATCH	Draw media from free if none is available in the pool. The default is not to draw from free.

   

• DeallocationPolicy
  Bit field indicating action at deallocation time. This member is writable. This can be the following value.

  Value	Meaning
  NTMS_DEALLOCATE_TOSCRATCH	Return media to free when available. The default is not to return to free.

   

• dwMaxAllocates
  Number of times the medium can be allocated and deallocated. This member is writable.

• dwNumberOfPhysicalMedia
  Number of physical media in this media pool.

• dwNumberOfLogicalMedia
  Number of logical media in this media pool.

• dwNumberOfMediaPools
  Number of media pools in this media pool.

Remarks

The NTMS_MEDIAPOOLINFORMATION 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