mme_video_get_status()

Get the video status

Synopsis:

#include <mme/mme.h>

int mme_video_get_status ( mme_hdl_t *hdl,
                           mm_video_status_t *status );


Arguments:

hdl
An MME connection handle.
status
A pointer to a mm_video_status_t structure that the function fills in with information about the video playback status.

Library:

mme

Description:

The function mme_video_get_status() gets status information for video playback of any format. The MME indicates that there has been a change in video status by sending a MME_EVENT_VIDEO_STATUS event.

To get DVD device status, use mme_dvd_get_status().

For more information about video dimensions and aspect ratio, see mm_video_info_t in this reference.

Events

None delivered.

Blocking and validation

This function blocks on io-media. It returns only when it has completed.

Returns:

0
Success.
-1
An error occurred (errno is set).

Examples:

From mmecli:

mm_video_status_t status;

rc = mme_video_get_status( mmehdl, &status );
if ( rc == -1 ) {
    sprintf( output, "Error getting video status: %s (%d).",
        strerror( errno ), errno );
} else {
    sprintf( output, "Size: %ux%u; Aspect Ratio: %ux%u.",
        status.width, status.height,
        status.aspect_ratio.w,status.aspect_ratio.h );
}

Classification:

QNX Neutrino

Safety:
Interrupt handler No
Signal handler No
Thread Yes

See also:

mme_video_get_angle_info(), mme_video_get_audio_info(), mme_video_get_info(), mme_video_get_subtitle_info(), mme_video_set_angle(), mme_video_set_audio(), mme_video_set_properties(), mme_video_set_audio()