IMDSPDeviceControl::Seek-Methode (mswmdm.h)

Artikel
08/25/2023

Die Seek-Methode sucht zu einer Position, die von den Play - oder Record-Methoden als Ausgangspunkt verwendet wird.

Syntax

HRESULT Seek(
  [in] UINT fuMode,
  [in] int  nOffset
);

Parameter

[in] fuMode

Modus für den ausgeführten Suchvorgang. Der fuMode-Parameter muss einer der folgenden Modi sein.

Mode	BESCHREIBUNG
MDSP_SEEK_BOF	Suchen Sie nach dem Anfang der Datei eine Position, die nOffset units ist.
MDSP_SEEK_CUR	Suchen Sie nach einer Position, die nOffset-Einheiten von der aktuellen Position ist.
MDSP_SEEK_EOF	Suchen Sie vor dem Ende der Datei eine Position, die nOffset units ist.

[in] nOffset

Anzahl der Einheiten, um die der Suchvorgang die Startposition weg von dem durch fuMode angegebenen Ursprung verschiebt. Die Einheiten von nOffset werden durch den Inhalt definiert. Sie können Millisekunden für Musik, Seiten für elektronische Bücher usw. betragen.

Ein positiver Wert für nOffset gibt an, dass die Datei vorwärts gesucht wird. Ein negativer Wert gibt an, dass die Datei rückwärts gesucht wird. Jede Kombination aus nOffset und fuMode , die angibt, dass vor dem Anfang der Datei oder nach dem Ende der Datei eine Position gesucht wird, ist ungültig und bewirkt, dass die Methode E_INVALIDARG zurückgibt.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_INVALIDARG	Mindestens ein Parameter ist ungültig.
WMDM_E_NOTSUPPORTED	Seek ist auf diesem Gerät nicht implementiert.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.

Hinweise

Die Suchposition wird definiert, indem entweder eine IWMDMStorage-Schnittstelle übergeben wird, die auf einen Speicherort auf einem Speichermedium des Geräts verweist, oder eine IWMDMOperation-Schnittstelle , die zur Unterstützung von Streamingaudio implementiert wurde. Die IMDSPObjectInfo-Schnittstelle kann auch übergeben werden, um einen Punkt innerhalb des Objekts zu beschreiben, auf den die angegebene Schnittstelle verweist.

Wenn seek bei der Gerätewiedergabe nicht vor der Wiedergabe aufgerufen wird, beginnt die Wiedergabe bei der ersten Audiospur auf dem ersten Speichermedium auf dem Mediengerät.

Wenn seek bei der Geräteaufzeichnung nicht vor Record aufgerufen wird, schlägt der Datensatzvorgang fehl. Nachdem die Record-Methode aufgerufen wurde, melden nachfolgende Aufrufe der IMDSPObjectInfo::GetLastPlayPosition-Methode jederzeit die Gesamtwiedergabelänge und entsprechen dem von IMDSPObjectInfo::GetTotalLength zurückgegebenen Wert. Die Aufzeichnungsdauer kann begrenzt werden, indem die IMDSPObjectInfo::SetPlayLength-Methode aufgerufen wird, nachdem sie vom Seek-Aufruf zurückgegeben wurde.