## MMPM/2 Device Driver Reference

[prev][next][parent][TOC]

### DDCMD_CONTROL

Select an item:

    Syntax
    Returns
    Remarks
    Example Code
    Glossary

This message performs a device-specific command.

pParmIn (PDDCMDCONTROL) A pointer to a DDCMDCONTROL data structure. The pParm and ulParmSize fields refer to the CONTROL_PARM data structure. Values for ulCmd include:

DDCMD_START Start a device.

DDCMD_STOP Stop a device and return current position.

DDCMD_PAUSE Pause a device and return current position.

DDCMD_RESUME Resume a paused device

DDCMD_ENABLE_EVENT Enable event detection.

DDCMD_DISABLE_EVENT Disable event detection in the device driver.

DDCMD_PAUSE_TIME Pause time but do not pause stream.

DDCMD_RESUME_TIME Resume time.

rc (ULONG) Error code indicating success or the type of failure:

NO_ERROR Success.

ERROR_INVALID_FUNCTION Illegal function requested.

ERROR_INVALID_REQUEST Device driver does not support events. (Returned when ulCmd of DDCMDCONTROL is set to DDCMD_ENABLE_EVENT.)

ERROR_INVALID_STREAM Invalid stream handle.

ERROR_INVALID_SEQUENCE Invalid device control command.

ERROR_INSUFF_BUFFER The device driver does not have buffers to perform the requested action.

ERROR_STREAM_NOT_STARTED The stream cannot perform the requested action unless the stream has been started.

ERROR_TOO_MANY_EVENTS The stream handler attempted to enable too many events.

FAILURE Device-driver-specific error return code.