repos_ecs/其他2015后/光盘刻录类/Nero 1.08SDK与例子/NeroSDK-1.08/NeroVisionAPI/Include/PreviewSimulation.idl

/******************************************************************************
|* THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
|* ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO
|* THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
|* PARTICULAR PURPOSE.
|* 
|* Copyright 1995-2005 Nero AG and its licensors. All Rights Reserved.
|*-----------------------------------------------------------------------------
|* NeroSDK / NeroVisionAPI
|*
|* PROGRAM: PreviewSimulation.idl
|*
|* PURPOSE: Interface definition of the NeroVision API
******************************************************************************/

[
  local, uuid(67240823-38DA-4693-A9C3-D4EEAC602CB8),
  helpstring("Callback interface given to the simulation to get notifications during playback")
]
interface IPreviewCallback : IUnknown
{
  HRESULT NotifyPosChanged([in] double pos, [in] int title, [in] int chapter);
  HRESULT NotifyPlaybackEnd();
};

[
  local, uuid(75A17C62-CCB7-4801-B1A1-C3868C8EF2FE),
  helpstring("Interface for previewing a project or title")
]
interface IPreview : IUnknown
{
  typedef [helpstring("The supported input keys for the simulation")]
  enum
  {
    SimulationKey_Play,
    SimulationKey_Pause,
    SimulationKey_Up,
    SimulationKey_Down,
    SimulationKey_Left,
    SimulationKey_Right,
    SimulationKey_Enter,
    SimulationKey_RootMenu,
    SimulationKey_TitleMenu,
    SimulationKey_Prev,
    SimulationKey_Next,
    SimulationKey_Return,
    SimulationKey_Numeric
  } SimulationKey;

  typedef [helpstring("The state of the simulation")]
  enum 
  {
    SimulationState_Stopped,
    SimulationState_Paused,
    SimulationState_Running
  } SimulationState;

  [helpstring("Sets the project and item to preview.")]
  HRESULT SetPreviewContext([in] IProject* project, [in] BSTR xmlID, [out, retval] boolean* pbSuccess);

  [helpstring("Specifies the placement of the preview window.")]
  HRESULT SetPreviewWindow([in] HANDLE_PTR hParentWnd, [in] int left, [in] int top, [in] int right, [in] int bottom, [out, retval] boolean* pbSuccess);

  [propput, helpstring("Sets the bitmap to display while no video is shown. The DIB handle must be freed by the caller.")]
  HRESULT BackgroundBitmap([in] HANDLE_PTR hDib);

  [propput, helpstring("Sets the color of the preview window while no video is shown.")]
  HRESULT BackgroundColor([in] COLORREF color);

  [helpstring("Forwards a message to the video window.")]
  HRESULT NotifyOwnerMessage([in] long uMsg, [in] long wParam, [in] long lParam);

  [helpstring("Starts the preview.")]
  HRESULT StartPreview([out, retval] boolean* pbSuccess);

  [helpstring("Stops the preview.")]
  HRESULT StopPreview();

  [helpstring("Sets the preview position to a title or chapter specified by an XML ID.")]
  HRESULT JumpToID([in] BSTR xmlID, [out, retval] boolean* pbSuccess);

  [helpstring("Sets the preview position to a chapter specified by title and chapter numbers.")]
  HRESULT JumpToChapter([in] int title, [in] int chapter, [out, retval] boolean* pbSuccess);

  [helpstring("Retrieves the current title and chapter numbers.")]
  HRESULT GetCurrentChapter([out] int* title, [out] int* chapter);

  [propget, helpstring("Gets the total duration of the title currently being previewed.")]
  HRESULT Duration([out, retval] double* duration);

  [propput, helpstring("Sets the audio volume.")]
  HRESULT Volume([in] double volume);
  [propget, helpstring("Gets the audio volume.")]
  HRESULT Volume([out, retval] double* volume);

  [propput, helpstring("Sets the preview position within the current title.")]
  HRESULT Position([in] double pos);
  [propget, helpstring("Gets the preview position within the current title")]
  HRESULT Position([out, retval] double* pos);

  [propget, helpstring("Gets the current state of the simulation.")]
  HRESULT State([out, retval] SimulationState* state);

  [helpstring("Provides key input to the simulation.")]
  HRESULT HandleKeyInput([in] SimulationKey key);

  [helpstring("Provides numeric input to the simulation.")]
  HRESULT HandleNumericInput([in] unsigned char num);

  [helpstring("Queries whether a specific key is supported by the preview.")]
  HRESULT IsKeySupported([in] SimulationKey key, [out, retval] boolean* supported);

  [propput, helpstring("Sets the callback interface for the preview.")]
  HRESULT Callback([in] IPreviewCallback* notify);

  [propget, helpstring("Gets the error object of the last called function.")]
  HRESULT LastError([out, retval] IError** pError);
};

[
  uuid(FDEC7B7F-1209-40bc-AA36-9CAC8CD1A35A),
  helpstring("Preview object"),
]
coclass Preview
{
  [default] interface IPreview;
};