IWMDMDeviceControl::Seek-Methode (mswmdm.h)

Artikel
08/25/2023

Die Seek-Methode sucht eine Position, die von der Play - oder Record-Methode als Ausgangspunkt verwendet wird.

Syntax

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

Parameter

[in] fuMode

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

Mode	BESCHREIBUNG
WMDM_SEEK_BEGIN	Suchen Sie nach einer Position, die nOffset-Einheiten nach dem Anfang der Datei ist.
WMDM_SEEK_CURRENT	Suchen Sie nach einer Position, die nOffset-Einheiten von der aktuellen Position ist.
WMDM_SEEK_END	Suchen Sie vor dem Ende der Datei nach einer Position, die nOffset-Einheiten ist.
WMDM_SEEK_REMOTECONTROL	Suchen Sie das herausnehmbare Steuerelement.
WMDM_SEEK_STREAMINGAUDIO	Suchen Sie das Streamingaudio.

[in] nOffset

Anzahl der Einheiten, um die der Suchvorgang die Startposition 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. sein.

Ein positiver Wert für nOffset gibt an, nach vorne durch die Datei zu suchen. Ein negativer Wert gibt an, rückwärts durch die Datei zu suchen. 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 IWMDMObjectInfo-Schnittstelle kann auch übergeben werden, um einen Punkt innerhalb des Objekts zu beschreiben, auf den die angegebene Schnittstelle verweist.

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

Wenn die Suche bei der Geräteaufzeichnung nicht vor Record aufgerufen wird, schlägt der Datensatzvorgang fehl. Die Aufzeichnungsdauer kann begrenzt werden, indem die IWMDMObjectInfo::SetPlayLength-Methode aufgerufen wird, nachdem sie vom Seek-Aufruf zurückgegeben wurde.