DDCMD_CONTROL - Description

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.

---

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