Syntax

  struct IdentifierRegistrationDef 
  { 
      LONG   classobjectsignature; 
      BYTE  *name; 
      LONG   type; 
      LONG   (*identifyroutine)( OBID ); 
      LONG   (*labelroutine)(  
                OBID,  
                struct RemovableInfoDef *); 
      LONG   (*unlabelroutine)( OBID ); 
      LONG   identificationRegID; 
  };
  

Fields

classobjectsignature

The identifier class signature MM_IDENTIFIER_SIGNATURE. This same signature should have been used to allocate the resource tag required by MM_RegisterObject.

name

The user-defined, null-terminated name of the identifier. Only the first MM_MAX_OBJECT_STRING_LEN - 1 characters are significant. The name is required.

type

Defines the type of identifier. See Section 10.25, Identifier Types for a complete list of currently defined identifiers.

identifyroutine

This routine is called during the activation of removable media in an attempt to identify the media. This uses the following:

• OBID – the object id of the device wherein the media is activating. This object id is passed to MM_SpecialObjectBlockingIO in the process of identifying the media.

labelroutine

This routine, if not NULL, is called when the label function is submitted to a media object and the specified identifier is registered with the Media Manager. This uses the following:

• OBID – the object id of the device containing the media to be labeled. This object id is passed to MM_SpecialObjectBlockingIO to place a label in the media.
• info – a pointer to the RemovableInfoDef structure that contains the label to be placed in the media.

unlabelroutine

This routine, if not NULL, is called when the unlabel function is submitted to a media object and the specified identifier is registered with the Media Manager. This uses the following:

• OBID – the object id of the device containing the media to be unlabeled. This object id is passed to MM_SpecialObjectBlockingIO in the process of unlabeling the media.

registeredHandle

Set to zero.

See Also

Identifier Class