Skip to content

Latest commit

 

History

History
149 lines (113 loc) · 4.58 KB

nf-mswmdm-iwmdmdevicecontrol-record.md

File metadata and controls

149 lines (113 loc) · 4.58 KB
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:mswmdm.IWMDMDeviceControl.Record
IWMDMDeviceControl::Record (mswmdm.h)
The Record method begins recording from the device's external record input at the current seek position. The IWMDMDeviceControl::Seek method must be called first.
IWMDMDeviceControl interface [windows Media Device Manager]
Record method
IWMDMDeviceControl.Record
IWMDMDeviceControl::Record
IWMDMDeviceControlRecord
Record
Record method [windows Media Device Manager]
Record method [windows Media Device Manager]
IWMDMDeviceControl interface
mswmdm/IWMDMDeviceControl::Record
wmdm.iwmdmdevicecontrol_record
wmdm\iwmdmdevicecontrol_record.htm
WMDM
a9372ce9-e339-4664-9e12-4feae29529dc
12/05/2018
IWMDMDeviceControl interface [windows Media Device Manager],Record method, IWMDMDeviceControl.Record, IWMDMDeviceControl::Record, IWMDMDeviceControlRecord, Record, Record method [windows Media Device Manager], Record method [windows Media Device Manager],IWMDMDeviceControl interface, mswmdm/IWMDMDeviceControl::Record, wmdm.iwmdmdevicecontrol_record
mswmdm.h
Windows
Mssachlp.lib
Windows
19H1
IWMDMDeviceControl::Record
mswmdm/IWMDMDeviceControl::Record
c++
APIRef
kbSyntax
COM
mssachlp.lib
mssachlp.dll
IWMDMDeviceControl.Record

IWMDMDeviceControl::Record

-description

The Record method begins recording from the device's external record input at the current seek position. The IWMDMDeviceControl::Seek method must be called first.

-parameters

-param pFormat [in]

Pointer to a _WAVEFORMATEX structure specifying the format in which the data must be recorded.

-returns

The method returns an HRESULT. Possible values include, but are not limited to, those in the following table.

Return code Description
S_OK
The method succeeded.
E_BUSY
The device is already performing an operation.
WMDM_E_NOTSUPPORTED
The record function is not implemented on this device.
E_FAIL
An unspecified error occurred.

-remarks

This method is used to invoke both device recording (recording of an audio track to be stored on the media device) and streaming audio data from the media device to be recorded on the computer. The Seek method determines which form of recording occurs.

Some devices do not support either type of recording. The GetCapabilities method must be called before you start recording. If an unsupported type of recording is attempted, this method returns WMDM_E_NOTSUPPORTED.

An argument can be supplied for the pFormat parameter to specify an audio format for recording. To determine the formats supported by the device, see GetFormatSupport. If the pFormat parameter is set to NULL, the device records audio data in the default format.

When you use device recording, you must enumerate the storage medium contents to find the new object after the record operation is finished.

-see-also

IWMDMDevice::GetFormatSupport

IWMDMDeviceControl Interface

IWMDMDeviceControl::GetCapabilities

IWMDMDeviceControl::Seek

IWMDMObjectInfo Interface

_WAVEFORMATEX