KsPinGetAvailableByteCount 함수(ks.h)

아티클
05/23/2024

KsPinGetAvailableByteCount 루틴은 호출자가 지정한 핀의 큐에 대해 선행 에지 앞의 입력 데이터 바이트 수와 선행 에지 앞에 있는 출력 버퍼의 바이트 수를 출력합니다.

구문

KSDDKAPI NTSTATUS KsPinGetAvailableByteCount(
  [in]            PKSPIN Pin,
  [out, optional] PLONG  InputDataBytes,
  [out, optional] PLONG  OutputBufferBytes
);

매개 변수

[in] Pin

이러한 큐 매개 변수를 계산할 KSPIN 구조체에 대한 포인터입니다.

[out, optional] InputDataBytes

루틴이 선행 에지보다 앞서 입력 데이터 바이트 수를 반환하는 LONG 값에 대한 포인터입니다. 이 값이 요청되지 않은 경우 호출자는 NULL 로 설정합니다.

[out, optional] OutputBufferBytes

루틴이 선행 에지보다 앞서 출력 버퍼 바이트 수를 반환하는 LONG 값에 대한 포인터입니다. 이 값이 요청되지 않은 경우 호출자는 NULL 로 설정합니다.

반환 값

요청된 개수를 검색한 경우 STATUS_SUCCESS 반환합니다. 반환 상태 실패는 Pin에 연결된 큐가 없음을 나타냅니다.

설명

비인플래스 핀은 입력 핀에 InputDataBytes 를 사용하고 출력 핀에는 OutputBufferBytes 를 사용해야 합니다.

이 호출의 결과는 처리 뮤텍스가 호출 시간에 유지되거나 호출자가 루틴을 호출하기 전에 비공개로 동기화되지 않는 한 안전하지 않습니다. 프라이빗 동기화하려면 루틴이 실행되는 동안 핀이 Acquire에서 Stop으로 전환되지 않는지 확인합니다. AVStream에서 뮤텍스 처리를 참조하세요.

또한 현재 위치 변환은 입력 및 출력 수를 제공할 수 있습니다.

Windows XP 및 DirectX 8.0에서는 필터가 수신하는 프레임이 가득 차 있지 않으면 InputDataBytes 수가 유효하지 않습니다.

자세한 내용은 선행 및 후행 Edge Stream 포인터를 참조하세요.

요구 사항

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