2.2.4.18 NTMS_MEDIAPOOLINFORMATION Structure

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

 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;

PoolType: An NTMS-supported media pool type.

Value	Meaning
NTMS_POOLTYPE_UNKNOWN 0x00000000	Unknown pool type.
NTMS_POOLTYPE_SCRATCH 0x00000001	Media that are available to other applications.
NTMS_POOLTYPE_FOREIGN 0x00000002	Media that have been written to and that do not contain a recognizable on-media identifier label type or label ID.
NTMS_POOLTYPE_IMPORT 0x00000003	Media that have been written to and that have a recognizable on-media identifier label type but an unrecognizable label ID.
NTMS_POOLTYPE_APPLICATION 0x00003E8	A media pool that is created by an application. One or more application media pools can be created per system.

MediaType: A single media type that makes up each media pool.

Parent: A parent media pool or NULL.

AllocationPolicy: A bitfield that specifies the action at allocation time. This MUST be the following value, or left as 0.

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

DeallocationPolicy: A bitfield that specifies action at deallocation time. This member can be the following value or left as 0.

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

dwMaxAllocates: The maximum number of times the medium can be allocated and deallocated.

dwNumberOfPhysicalMedia: The number of physical media in this media pool.

dwNumberOfLogicalMedia: The number of logical media in this media pool.

dwNumberOfMediaPools: The number of media pools in this media pool.