mmpSetInfo

Syntax

BOOL mmpSetInfo(idMovie, nIndex, lpData, wLen)

Sets new values for internal movie data of the Movie Player instance. Since this function directly sets variables used by the movie, setting improper values can cause a general protection fault or crash the Movie Player. Do not call this function while the movie is animating.

Parameters

MMPID idMovie

Identifies the movie ID of the Movie Player instance.

int nIndex

Specifies the type of data to provide to the Movie Player instance. Use one of the following constants:

MMPINFO_LABELLIST

Sets the handle to the label-list array. The lpData parameter must point to a handle that references a global memory block containing an array of MMPLABEL records. The label-list information must be compatible with the MMP label-text block. See the documentation on the MMPLABEL structure for information on the label-list format.

MMPINFO_LABELTEXT

Set the handle to the label text block. The lpData parameter must point to a handle that references a global memory block containing a block of label text. The label text must be compatible with the MMP label-list information.

MMPINFO_LABELCOUNT

Set the count of label entries. The lpData parameter must point to a WORD-sized count value.

MMPINFO_ACTIONLIST

Set the handle to the action-list array. The action list contains the script-channel commands for the movie. The lpData parameter must point to a handle that references a global memory block containing an array of MMPACTION records. The action-list information must be compatible with the MMP action-text block. See the documentation on the MMPACTION structure for information on the action-list format.

MMPINFO_ACTIONTEXT

Set the handle to the action-text block. The lpData parameter must point to a handle that references a global memory block containing a block of action text. The action text must be compatible with the MMP action-list information.

MMPINFO_ACTIONCOUNT

Set the count of action entries. The lpData parameter must point to a WORD-sized count value.

LPVOID lpData

Specifies a far pointer to the data to supply to the Movie Player instance. The memory area pointed to by this parameter must be the correct size for the data item identified by the nIndex value.

WORD wLen

Specifies the length of the memory location pointed to by the lpData parameter.

Return Value

Returns TRUE if successful; otherwise, returns FALSE.

Comments

For both the label and action-entry data, the three data items (label-list or action-list array, text block, and count value) are dependent on each other. When changing the label or action entry information, change all relevant data items as a single operation before yielding control.

See Also

mmpGetInfo