IMDSPDeviceControl::Record-Methode (mswmdm.h)

Artikel
08/25/2023

Die Record-Methode beginnt mit der Aufzeichnung über die externe Datensatzeingabe des Geräts an der aktuellen Suchposition. Die Seek-Methode muss zuerst aufgerufen werden.

Syntax

HRESULT Record(
  [in] _WAVEFORMATEX *pFormat
);

Parameter

[in] pFormat

Zeiger auf eine _WAVEFORMATEX-Struktur , die das Format enthält, in dem die Daten aufgezeichnet werden müssen.

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_BUSY	Das Gerät führt bereits einen Vorgang aus.
WMDM_E_NOTSUPPORTED	Die Datensatzfunktion ist auf diesem Gerät nicht implementiert.
E_FAIL	Es ist ein unbekannter Fehler aufgetreten.

Hinweise

Diese Methode wird verwendet, um sowohl die Geräteaufzeichnung (Aufzeichnung einer Audiospur, die auf dem Mediengerät gespeichert werden soll) als auch das Streaming von Audiodaten vom Mediengerät aufzurufen, die auf dem Computer aufgezeichnet werden sollen. Die Seek-Methode bestimmt, welche Form der Aufzeichnung auftritt.

Einige Geräte unterstützen keine beiden Aufzeichnungstypen. Die GetCapabilities-Methode muss aufgerufen werden, bevor Sie mit der Aufzeichnung beginnen. Wenn ein nicht unterstützter Aufzeichnungstyp versucht wird, gibt diese Methode WMDM_E_NOTSUPPORTED zurück.

Ein Argument für den pFormat-Parameter kann angegeben werden, um ein Audiodatenformat für die Aufzeichnung anzugeben. Informationen zum Ermitteln der vom Gerät unterstützten Formate finden Sie unter IMDSPDevice::GetFormatSupport. Wenn der pFormat-Parameter auf NULL festgelegt ist, zeichnet das Gerät Audiodaten im Standardformat auf.

Wenn Sie die Geräteaufzeichnung verwenden, müssen Sie den Inhalt des Speichermediums auflisten, um das neue Objekt nach Abschluss des Datensatzvorgangs zu finden.