IPortWavePciStream::TerminatePacket 메서드(portcls.h)

메서드는 TerminatePacket 현재 매핑되는 패킷을 종료합니다.

구문

NTSTATUS TerminatePacket();

반환 값

TerminatePacket 는 호출에 성공하면 STATUS_SUCCESS 반환합니다. 그렇지 않으면 메서드는 적절한 오류 코드를 반환합니다.

설명

이 메서드는 주로 I/O 패킷이 스트림의 특정 지점에서 끝나야 하는 캡처 상황(예: 비디오 프레임과 동기화)에 사용됩니다. 오디오 디바이스의 캡처 핀에 대한 데이터 버퍼는 하나 이상의 I/O 패킷으로 구성됩니다. 각 I/O 패킷은 특정 매핑 IRP에 연결된 데이터 버퍼의 부분입니다. 기본적으로 캡처 스트림이 KSSTATE_RUN 상태인 동안 패킷의 마지막 매핑이 채워진 경우에만 I/O 패킷의 콘텐츠를 클라이언트에서 사용할 수 있게 됩니다. 메서드는 TerminatePacket 추가 캡처 데이터를 기다리지 않고 부분적으로 채워진 패킷을 클라이언트에서 즉시 사용할 수 있도록 합니다.

캡처 스트림의 상태를 KSSTATE_RUN KSSTATE_STOP 변경하면 현재 I/O 패킷이 자동으로 종료됩니다.

요구 사항

요구 사항
대상 플랫폼 유니버설
헤더 portcls.h(Portcls.h 포함)
IRQL <=DISPATCH_LEVEL