IMFASFIndexer::CommitIndex 메서드(wmcontainer.h)
ASF 콘텐츠와 연결된 ContentInfo 개체에 새 인덱스 정보를 추가합니다. 인덱서를 나중에 인덱서에서 읽을 수 있도록 인덱스 내용을 복사하기 전에 이 메서드를 호출해야 합니다.
구문
HRESULT CommitIndex(
[in] IMFASFContentInfo *pIContentInfo
);
매개 변수
[in] pIContentInfo
콘텐츠를 설명하는 ContentInfo 개체의 IMFASFContentInfo 인터페이스에 대한 포인터입니다.
반환 값
이 메서드는 HRESULT를 반환합니다. 가능한 값에는 다음 표에 있는 값이 포함되지만, 이에 국한되는 것은 아닙니다.
| 반환 코드 | Description |
|---|---|
|
메서드가 성공했습니다. |
|
호출자가 잘못된 요청을 했습니다. 자세한 내용은 설명 부분을 참조하세요. |
설명
인덱스가 제대로 작동하려면 파일의 모든 ASF 패킷이 IMFASFIndexer::GenerateIndexEntries 메서드를 사용하여 인덱서에 전달된 후 이 메서드를 호출해야 합니다. 이 메서드를 호출한 후에 는 GetCompletedIndex 를 호출하여 인덱스를 검색하고 파일의 적절한 위치에 기록해야 합니다. 마지막으로 ASF ContentInfo 개체의 IMFASFContentInfo::GenerateHeader 메서드를 호출하여 새 ASF 헤더를 생성해야 합니다.
애플리케이션은 새 인덱스를 작성할 때만 CommitIndex 메서드를 사용해야 합니다. 그렇지 않으면 CommitIndex 는 결과적으로 MF_E_INVALIDREQUEST 반환할 수 있습니다. 예를 들어 애플리케이션에 인덱서 개체에 설정된 MFASF_INDEXER_WRITE_NEW_INDEX 이외의 플래그가 있는 경우 MF_E_INVALIDREQUEST 반환됩니다. 또한 CommitIndex 는 이전 CommitIndex 호출을 통해 인덱스 항목이 이미 커밋된 경우 MFASF_INDEXER_WRITE_NEW_INDEX 반환할 수 있습니다.
인덱스 읽기 시나리오에서는 이 메서드를 사용할 수 없습니다. 인덱스를 작성할 때만 이 메서드를 사용할 수 있습니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Windows Vista [데스크톱 앱만 해당] |
| 지원되는 최소 서버 | Windows Server 2008 [데스크톱 앱만 해당] |
| 대상 플랫폼 | Windows |
| 헤더 | wmcontainer.h |
| 라이브러리 | Mfuuid.lib |