ulParam1 (ULONG)

      This parameter can contain any of the following:

      MCI_NOTIFY

        A notification message will be posted to the window specified in the hwndCallback parameter of the data structure pointed to by the pParam2 parameter. The notification will be posted when the action indicated by this message is completed or when an error occurs.
      MCI_WAIT
        Control is not to be returned until the action indicated by this message is completed or an error occurs.
      Digital Video Extensions

      The following additional flags apply to digital video devices supporting MCI_PUT:

      MCI_DGV_PUT_RECT

        This flag specifies that the rc field of the data structure identified by pParam2 contains a valid display rectangle array. This is a required parameter.
      MCI_DGV_PUT_SOURCE
        Indicates that the rc field of the data structure identified by pParam2 contains a display rectangle array specifying the offset and size of a clipping rectangle for the digital video source image. The source rectangle array specifies a capture rectangle relative to the digital video origin. MCI_DGV_PUT_SOURCE is only valid with the MCI_DGV_RECORD flag.

        Note: The size of the origin (or source) can be found using MCI_DGV_STATUS_VIDEO_X_EXTENT and MCI_DGV_STATUS_VIDEO_Y_EXTENT.

      MCI_DGV_PUT_DESTINATION
        Indicates that the rc field of the data structure identified by pParam2 contains a display rectangle array specifying the offset and visible extent of the digital video within the client window. The destination rectangle array specifies a clipping rectangle for frames relative to the lower-left corner of the window. When MCI_DGV_PUT_DESTINATION is used with MCI_DGV_RECORD, the size of the movie to be recorded is determined and the position is ignored. When MCI_DGV_PUT_DESTINATION is used with MCI_DGV_MONITOR, the size and position of the monitor video relative to the monitor window is determined. If MCI_DGV_PUT_DESTINATION is used without either MCI_DGV_MONITOR or MCI_DGV_RECORD, the size and position of the playback video relative to the playback window is determined.
      MCI_DGV_PUT_WINDOW_MOVE
        Indicates that the rc field of the data structure identified by pParam2 contains a display rectangle specifying the window position. All four values (X1 Y1 X2 Y2) must be specified, but X2 and Y2 are ignored unless the MCI_DGV_PUT_WINDOW_SIZE parameter is also specified.
      MCI_DGV_PUT_WINDOW_SIZE
        Indicates that the rc field of the data structure identified by pParam2 contains a display rectangle that specifies the size of the window. All four values (X1 Y1 X2 Y2) must be specified.
      MCI_DGV_RECORD
        Specifies the source and destination rectangles for video capture.

        Note: For recording, the source rectangle specifies the portion of the image to be captured and the destination rectangle specifies the size of the video to be recorded, thereby indicating the scaling to be applied to the source rectangle.

      MCI_DGV_MONITOR
        This flag specifies the window size and position for the monitor window.
      Video Overlay Extensions

      The following additional flags apply to video overlay devices:

      MCI_OVLY_PUT_RECT

        Specifies that the rc field of the data structure identified by pParam2 contains a valid display rectangle.
      MCI_OVLY_PUT_DESTINATION
        Indicates that the rc field of the data structure identified by pParam2 contains a display rectangle for the video overlay within the client window. The destination rectangle specifies a clipping rectangle for frames relative to the lower-left corner of the window. If MCI_OVLY_PUT_DESTINATION is specified without the MCI_OVLY_PUT_RECT flag specified, the default destination is set.
      MCI_OVLY_PUT_SOURCE
        Indicates that the rc field of the data structure identified by pParam2 contains a display rectangle for the analog video source. The source rectangle specifies the portion of the incoming video signal which will be displayed. If MCI_OVLY_PUT_SOURCE is specified without the MCI_OVLY_PUT_RECT flag specified, the default source is set.
      MCI_OVLY_PUT_WINDOW_MOVE
        Indicates that the rc field of the data structure identified by pParam2 contains a display rectangle, where the X1 Y1 coordinates specify the new location of the default video window. The coordinates are relative to the parent window. The X2 and Y2 coordinates are ignored unless the MCI_OVLY_PUT_WINDOW_SIZE flag is also specified.
      MCI_OVLY_PUT_WINDOW_SIZE
        Indicates that the rc field of the data structure identified by pParam2 contains a display rectangle. The new default window size is calculated to ((X2 - X1) + 1) and ((Y2 - Y1) + 1).

      [Back] [Next]