Function Name: General Convert Fields

Definition

Converts src_fields_ptr (defined in one DRM version) to dest_fields_ptr (in another DRM version).

Returns

SE_DRM_SUCCESS - and *dest_fields_ptr is set appropriately, if valid parameters were passed in.

SE_DRM_NULL_REQUIRED_PARAMETER - and *dest_fields_ptr is left unaltered, if src_fields_ptr or dest_fields_ptr is NULL.

SE_DRM_INVALID_VERSION - and *dest_fields_ptr is left unaltered, if the specified version conversion of the DRM is not supported.

SE_DRM_FAILURE - and pointers within *dest_fields_ptr are set to NULL, if memory required for pointers within the target structure cannot be allocated.

Prototype


extern SE_DRM_STATUS_CODE_ENUM
SE_GeneralConvertFields
(
SE_PINT16 src_major_drm_version, (notes)
SE_UINT8 src_minor_drm_version, (notes)
constvoid *src_fields_ptr, (notes)
SE_PINT16 dest_major_drm_version, (notes)
SE_UINT8 dest_minor_drm_version, (notes)
void *dest_fields_ptr (notes)
);

Parameters Notes

src_major_drm_version

 major DRM version number of the DRM version for which this
 function is being called

src_minor_drm_version

 minor DRM version number of the DRM version for which this
 function is being called

src_fields_ptr

 pointer to the source fields being converted

dest_major_drm_version

 major DRM version number of the DRM version for which this
 function is being called

dest_minor_drm_version

 minor DRM version number of the DRM version for which this
 function is being called

dest_fields_ptr

 pointer to the destination fields, the target

Prev: General Class Name To Token. Next: General Enumerator Name. Up:Index.