IDVDRenderer::Abort
Other versions of this page are also available for the following:
.gif "A hyphen indicates that the information in this topic is not relevant for this platform, or that the platform does not support the API that is listed.")
.gif "A checkmark indicates that the information in this topic is relevant for this platform, and that any API listed is also supported on this platform.")
8/28/2008
This method immediately aborts any decoding and rendering processes and flushes the internal data buffers.
Syntax
HRESULT Abort();
Parameters
None.
Return Value
If the method completes successfully, the return value is S_OK.
Remarks
The navigator can call the IDVDRenderer::Abort method directly to reset the decoder in response to playback timing events. This method can be used to mark a block of data in the stream for a decoder to be aborted between two data transfers after playback of the first data stream is over. This can also be used to resume playback. The navigator chooses the most convenient method for itself to indicate discontinuity. As a result, the decoder/renderer gets reset, and the system time clock (STC) and the rest change to the idle state to wait to play again.
Temporal discontinuity can be detected, in general, anywhere on the cell boundary. In particular, it can be detected during usual playback control and navigation operations, which include, moving to the menu from the title and back to the title again, or skipping a program.
The following table shows some of the uses for the IDVDRenderer::Abort method.
| Use | Description |
|---|---|
Disk Authentication |
Call the IDVDRenderer::Abort method before going into the protocol. |
Title Renegotiation |
Wait for playback timing notification (PBT), call Abort, and then proceed with the protocol. |
Before sending palette and selecting streams |
Every PGC starts with the Abort method before sending palette and selecting streams. |
Before sending new VOBU |
If a new video object unit (VOBU) is indicated as discontinuous, wait for PBT then use Abort before writing a new VOBU to the renderer. |
Note
In the preceding scenarios, there is a high probability that the content following a call to IDVDRenderer::Abort will have a temporal discontinuity. There could be several Abort calls in a row before the Play/Scan command is issued.
Requirements
| Header | dvddrvr.idl |
| Windows Embedded CE | Windows CE .NET 4.0 and later |