Reference Manual - 0.9.25
IDirectFBVideoProvider   PlayTo

Play the video rendering it into the specified rectangle of the destination surface.

PlayTo (
  IDirectFBVideoProvider   * thiz,
  IDirectFBSurface   * destination,
  const DFBRectangle   * destination_rect,
  DVFrameCallback   callback,
  void   * ctx
);

Optionally a callback can be registered that is called for each rendered frame. This is especially important if you are playing to a flipping surface. In this case, you should flip the destination surface in your callback.