KsStreamPointerAdvance 함수(ks.h)

아티클
02/26/2024

KsStreamPointerAdvance 함수는 스트림 포인터를 다음 데이터 프레임으로 진행합니다.

구문

KSDDKAPI NTSTATUS KsStreamPointerAdvance(
  [in] PKSSTREAM_POINTER StreamPointer
);

매개 변수

[in] StreamPointer

스트림 포인터를 나타내는 KSSTREAM_POINTER 구조체에 대한 포인터로, 사용 가능한 다음 데이터 프레임을 참조합니다.

반환 값

KsStreamPointerAdvance 는 성공적인 발전을 나타내기 위해 STATUS_SUCCESS 반환합니다. 그렇지 않으면 오류 코드를 반환합니다. STATUS_DEVICE_NOT_READY 가장 자주 반환되는 오류 코드이며, 고급이 실패한 후 스트림 포인터를 잠그는 것을 나타내는 경우가 많습니다. 즉, StreamPointer 는 큐의 마지막 프레임을 참조합니다.

설명

호출 시 StreamPointer가 잠겨 있는 경우 AVStream은 이를 진행하기 전에 잠금을 해제합니다. 고급이 되면 스트림 포인터가 새 프레임의 원래 상태(잠기거나 잠금 해제됨)로 다시 배치됩니다.

잠금 해제된 스트림 포인터를 계속 진행하려는 시도는 항상 성공하고 STATUS_SUCCESS 반환합니다. 스트림 포인터가 잠겨 있지 않으므로 스트림 포인터가 실제 데이터를 참조하는지 확인할 방법이 없습니다. 미니 드라이버는 잠금을 시도하여 새로 고급 스트림 포인터가 데이터 프레임을 참조하는지 여부를 확인해야 합니다.

또한 Stream 포인터를 참조하세요.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	Microsoft Windows XP 이상 운영 체제 및 DirectX 8.0 이상 DirectX 버전에서 사용할 수 있습니다.
대상 플랫폼	유니버설
헤더	ks.h(Ks.h 포함)
라이브러리	Ks.lib
IRQL	<=DISPATCH_LEVEL