CBaseControlVideo.GetVideoPaletteEntries 메서드

  • 아티클

[이 페이지와 연결된 기능인 DirectShow는 레거시 기능입니다. MediaPlayer, IMFMediaEngine 및 Media Foundation의 오디오/비디오 캡처로 대체되었습니다. 이러한 기능은 Windows 10 및 Windows 11 최적화되었습니다. 가능한 경우 새 코드에서 DirectShow 대신 MediaPlayer, IMFMediaEngine 및 오디오/비디오 캡처를 사용하는 것이 좋습니다. 가능한 경우 레거시 API를 사용하는 기존 코드를 다시 작성하여 새 API를 사용하도록 제안합니다.]

메서드는 GetVideoPaletteEntries 비디오에 대한 색상표 항목의 범위를 검색합니다.

구문

HRESULT GetVideoPaletteEntries(
   long StartIndex,
   long Entries,
   long *pRetrieved,
   long *pPalette
);

매개 변수

Startindex

0부터 시작하는 시작 팔레트 항목입니다.

항목

필요한 항목 수입니다.

pRetrieved

가져온 색 수에 대한 포인터입니다.

pPalette

색에 대한 출력 버퍼에 대한 포인터입니다.

반환 값

성공하면 NOERROR를 반환하고, 비디오 샘플에 색상표가 없는 경우, 사용 가능한 메모리가 충분하지 않은 경우 E_OUTOFMEMORY, StartIndex 가 유효하지 않은 경우 E_INVALIDARG, 색상표에 색이 없는 경우 S_FALSE VFW_E_NO_PALETTE_AVAILABLE NOERROR를 반환합니다.

설명

이 멤버 함수는 비디오의 현재 팔레트를 사용자가 할당한 배열로 반환합니다. 일관성을 유지하려면 Win32 PALETTEENTRY 구조체의 멤버를 사용하여 RGBQUAD 구조의 멤버가 아닌 색을 반환합니다(매개 변수는 LONG임). 메모리는 호출자에 의해 할당되므로 각각을 차례로 복사하기만 하면됩니다. 요청된 항목 수와 시작 위치 오프셋이 모두 유효한지 확인합니다. 항목 수가 0으로 평가되면 S_FALSE 코드를 반환합니다.

요구 사항

요구 사항 값
헤더
Ctlutil.h(Streams.h 포함)
라이브러리
Strmbase.lib(소매 빌드);
Strmbasd.lib(디버그 빌드)

추가 정보

CBaseControlVideo 클래스