2.2.3.1 NtmsAllocateOptions Enumeration

  • Article

The NtmsAllocateOptions enumeration defines options for media allocation.

 enum NtmsAllocateOptions
 {
   NTMS_ALLOCATE_NEW = 0x0001,
   NTMS_ALLOCATE_NEXT = 0x0002,
   NTMS_ALLOCATE_ERROR_IF_UNAVAILABLE = 0x0004
 };

NTMS_ALLOCATE_NEW:  Allocates a side of the specified medium that MUST NOT be shared with another application's logical media. For example, this value could be used to reserve the second side of a piece of two-sided optical media. This value is mutually exclusive with NTMS_ALLOCATE_NEXT, and the user MUST NOT use both values in the same call.

NTMS_ALLOCATE_NEXT:  MUST allocate the next side of the multisided medium that was previously allocated with the NTMS_ALLOCATE_NEW value. This allows a single application to use both sides of a two-sided medium, and ensures that the application owns all the data on the physical medium. If all sides of the medium are already allocated, the request MUST fail. This value is mutually exclusive with NTMS_ALLOCATE_NEW, and the user MUST NOT use both values in the same call.

NTMS_ALLOCATE_ERROR_IF_UNAVAILABLE:  MUST prevent the submission of an operator request for new media if none can be allocated with the specified constraints.