Microsoft DirectX 9.0

IDvdControl2::SetState

The SetState method saves the current disc position and state of the DVD Navigator filter.

Syntax

HRESULT SetState(
  IDvdState *pState,
  DWORD    dwFlags,
  IDvdCmd  **ppCmd
);

Parameters

pState

[in] Pointer to the IDvdState interface on the object that contains the state information.

dwFlags

[in] Bit flag that contains one or more DVD_CMD_FLAGS values specifying command synchronization options.

ppCmd

[out] Address of a pointer to an IDvdCmd object that can be used to synchronize DVD commands.

Return Values

Returns S_OK if successful, or an HRESULT value otherwise.

Remarks

The DVD Navigator uses the location information in the given state object to restore the playback position to a specific location on the disc.

This method is demonstrated in the DVDSample application in CDvdCore::RestoreBookmark.

See Also