MFCreateSequencerSegmentOffset-Funktion (mfidl.h)

  • Artikel

Erstellt eine PROPVARIANT-Instanz , die zum Suchen in einer Sequenzerquellpräsentation verwendet werden kann.

Syntax

HRESULT MFCreateSequencerSegmentOffset(
  [in]  MFSequencerElementId dwId,
  [in]  MFTIME               hnsOffset,
  [out] PROPVARIANT          *pvarSegmentOffset
);

Parameter

[in] dwId

Sequencer-Elementbezeichner. Dieser Wert gibt das Segment an, in dem mit der Wiedergabe begonnen werden soll. Der Elementbezeichner wird in der METHODE IMFSequencerSource::AppendTopology zurückgegeben.

[in] hnsOffset

Startposition innerhalb des Segments in 100 Nanosekundeneinheiten.

[out] pvarSegmentOffset

Zeiger auf eine PROPVARIANT. Die -Methode füllt propvariant mit den Informationen aus, die zum Ausführen eines Suchvorgangs erforderlich sind. Der Aufrufer muss propvariant durch Aufrufen von PropVariantClear freigeben.

Rückgabewert

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Der in pvarSegmentOffset zurückgegebene PROPVARIANT kann für den pvarStartPosition-Parameter in der IMFMediaSession::Start-Methode verwendet werden. Verwenden Sie die ZEITformat-GUID MF_TIME_FORMAT_SEGMENT_OFFSET.

Beispiele

// Skips to the specified segment in the sequencer source

HRESULT CPlaylist::SkipTo(DWORD index)
{
    if (index >= m_count)
    {
        return E_INVALIDARG;
    }

    MFSequencerElementId ID = m_segments[index].SegmentID;

    PROPVARIANT var;

    HRESULT hr = MFCreateSequencerSegmentOffset(ID, NULL, &var);
    
    if (SUCCEEDED(hr))
    {
        hr = m_pSession->Start(&MF_TIME_FORMAT_SEGMENT_OFFSET, &var);
        PropVariantClear(&var);
    }
    return hr;
}

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile mfidl.h
Bibliothek Mf.lib
DLL Mf.dll

Weitere Informationen

MFTIME

Media Foundation-Funktionen

Sequencerquelle

Verwenden der Sequencerquelle