mciPlayResource - Parameters

hwndOwner (HWND) - input

Window handle of the owner window. If this parameter is NULL then the currently active window is used.

hmod (HMODULE) - input

Module handle of the module that contains the resource. The resource is loaded using DosGetResource. NULL indicates the program file's resources.

resType (ULONG) - input

Defines resource type with one of the following values:

RT_WAVE

Resource type is digital audio.
RT_AVI
Resource type is digital video using the AVI file format.
RT_RMID
Resource type is MIDI.
RT_RIFF
Resource type is RIFF. Any of the resource types can be contained within this resource type.

resID (ULONG) - input

Identifier for resource.

ulFlags (ULONG) - input

MCI_OWNERISPARENT

Indicates that the owner window should be used as the parent window for any default window that is created. If this flag is passed to a device that does not support a parent window, an error is returned.
MCI_STOPACTIVE
Indicates that any currently active PLAY command issued by mciPlayFile or mciPlayResource should be stopped.
MCI_ASYNC
Indicates that the command should be processed asynchronously. A rendezvous command will not be done.
MCI_ASYNCRENDEZVOUS
Indicates that the command should be processed asynchronously. A rendezvous command will be done.
MCI_RENDEZVOUS
Indicates that the call should wait for a currently pending asynchronous command to complete.

• If no command is pending, then it returns immediately.

• If an asynchronous command is not pending, this function returns immediately. This flag indicates that the command should wait until a pending asynchronous play command completes and then return.

• If a synchronous (default) play command is pending, this command returns immediately with a MCIERR_NO_ASYNC_PLAY_ACTIVE.

• If another MCI_RENDEZVOUS command is pending, this command should return immediately with a MCIERR_ASYNC_PLAY_ACTIVE.

pszTitle (PSZ) - input

Title for window if one is generated. The title is ignored if a window would not be generated.

hwndViewport (HWND) - input

Window handle for displaying the video image. If a viewport window is not specified, then a default video window is displayed. This parameter only has an effect when the data type supports video.

rc (ULONG) - returns

Return codes indicating success or type of failure:

MCIERR_SUCCESS

If the function succeeds, 0 is returned.
MCIERR_NO_ASYNC_PLAY_ACTIVE
A synchronous (default) play command is pending or no asynchronous play is currently active for the associated owner window.
MCIERR_MISSING_PARAMETER
Required parameter is missing.
MCIERR_FILE_ATTRIBUTE
Returned if another application has opened or acquired the same device for exclusive use.
MCIERR_INSTANCE_INACTIVE
The device is currently inactive. Issue MCI_ACQUIREDEVICE message to activate device ID.
MCIERR_UNSUPPORTED_FLAG
Given flag is unsupported for this device.
MCIERR_INVALID_CALLBACK_HANDLE
Given callback handle is invalid.
MCIERR_UNSUPPORTED_FUNCTION
Unsupported function.
MCIERR_FLAGS_NOT_COMPATIBLE
Flags can not be used together.
MCIERR_FILE_NOT_FOUND
File has not been loaded.
MCIERR_DUPLICATE_ALIAS
Alias already exists.
MCIERR_INVALID_BUFFER
Invalid return buffer given.
MCIERR_CANNOT_LOAD_DRIVER
The driver could not be loaded.
MCIERR_DEVICE_LOCKED
The device is acquired for exclusive use.
MCIERR_OUT_OF_MEMORY
Out of memory.

---

[Back: mciPlayResource Return Value - rc]
[Next: mciPlayResource - Remarks]