update documentation for the getMediaIndexByTime routine

per @dmlap request.
@rdabreo - the return type is listed here