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

아티클
02/29/2024

Seek 메서드는 Play 또는 Record 메서드에서 시작점으로 사용되는 위치를 찾습니다.

구문

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

매개 변수

[in] fuMode

수행 중인 검색 작업에 대한 모드입니다. fuMode 매개 변수는 다음 모드 중 하나여야 합니다.

Mode	Description
MDSP_SEEK_BOF	파일 시작 후 nOffset 단위인 위치를 찾습니다.
MDSP_SEEK_CUR	현재 위치에서 nOffset 단위인 위치를 찾습니다.
MDSP_SEEK_EOF	파일이 끝나기 전에 nOffset 단위인 위치를 찾습니다.

[in] nOffset

seek 연산이 시작 위치를 fuMode로 지정된 원점에서 멀리 이동하는 단위 수입니다. nOffset의 단위는 콘텐츠에 의해 정의됩니다. 음악, 전자책 페이지 등에 대한 밀리초일 수 있습니다.

nOffset에 대한 양수 값은 파일을 통해 앞으로 검색을 나타냅니다. 음수 값은 파일을 역방향으로 검색하는 것을 나타냅니다. nOffset 및 fuMode의 조합은 파일의 시작 전이나 파일의 끝 이후의 위치를 검색하는 것을 나타내며 메서드가 E_INVALIDARG 반환하도록 합니다.

반환 값

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

반환 코드	Description
S_OK	메서드가 성공했습니다.
E_INVALIDARG	하나 이상의 매개 변수가 잘못되었습니다.
WMDM_E_NOTSUPPORTED	Seek는 이 디바이스에서 구현되지 않습니다.
E_FAIL	지정되지 않은 오류가 발생했습니다.

설명

검색 위치는 디바이스의 스토리지 매체에 있는 위치를 가리키는 IWMDMStorage 인터페이스 또는 스트리밍 오디오를 지원하기 위해 구현된 IWMDMOperation 인터페이스를 전달하여 정의됩니다. IMDSPObjectInfo 인터페이스를 전달하여 지정된 인터페이스가 가리키는 개체 내의 일부 지점을 설명할 수도 있습니다.

디바이스 재생의 경우 Play 전에 Seek를 호출하지 않으면 미디어 디바이스의 첫 번째 스토리지 매체에 있는 첫 번째 오디오 트랙에서 재생이 시작됩니다.

디바이스 기록의 경우 Record 전에 Seek를 호출하지 않으면 레코드 작업이 실패합니다. Record 메서드가 호출된 후 IMDSPObjectInfo::GetLastPlayPosition 메서드에 대한 후속 호출은 언제든지 총 재생 길이를 보고하고 IMDSPObjectInfo::GetTotalLength에서 반환된 값과 같습니다. Seek 호출에서 반환된 후 IMDSPObjectInfo::SetPlayLength 메서드를 호출하여 기록 길이를 제한할 수 있습니다.