IMDSPDeviceControl::Record 메서드(mswmdm.h)

아티클
02/29/2024

Record 메서드는 현재 검색 위치에 있는 디바이스의 외부 레코드 입력에서 녹음/녹화를 시작합니다. Seek 메서드를 먼저 호출해야 합니다.

구문

HRESULT Record(
  [in] _WAVEFORMATEX *pFormat
);

매개 변수

[in] pFormat

데이터를 기록해야 하는 형식을 포함하는 _WAVEFORMATEX 구조체에 대한 포인터입니다.

반환 값

이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_BUSY	디바이스가 이미 작업을 수행하고 있습니다.
WMDM_E_NOTSUPPORTED	레코드 함수는 이 디바이스에서 구현되지 않습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.

설명

이 메서드는 디바이스 녹음(미디어 디바이스에 저장할 오디오 트랙 녹음)과 컴퓨터에 기록될 미디어 디바이스의 스트리밍 오디오 데이터를 모두 호출하는 데 사용됩니다. Seek 메서드는 어떤 형태의 녹음/녹화가 발생하는지 결정합니다.

일부 디바이스는 두 가지 유형의 녹음/녹화를 지원하지 않습니다. 기록을 시작하기 전에 GetCapabilities 메서드를 호출해야 합니다. 지원되지 않는 녹음/녹화 유형을 시도하면 이 메서드는 WMDM_E_NOTSUPPORTED 반환합니다.

녹음을 위한 오디오 데이터 형식을 지정하기 위해 pFormat 매개 변수에 대한 인수를 제공할 수 있습니다. 디바이스에서 지원하는 형식을 확인하려면 IMDSPDevice::GetFormatSupport를 참조하세요. pFormat 매개 변수가 NULL로 설정된 경우 디바이스는 오디오 데이터를 기본 형식으로 기록합니다.

디바이스 기록을 사용하는 경우 레코드 작업이 완료된 후 새 개체를 찾으려면 스토리지 미디어 콘텐츠를 열거해야 합니다.