IKsInterfaceHandler::KsCompleteIo 메서드(ksproxy.h)

아티클
02/26/2024

KsCompleteIo 메서드는 확장 헤더를 정리하고 입력 및 출력(I/O)이 완료된 후 미디어 샘플을 해제합니다.

구문

HRESULT KsCompleteIo(
  [in, out] PKSSTREAM_SEGMENT StreamSegment
);

매개 변수

[in, out] StreamSegment

완료할 스트림 세그먼트에 대한 헤더 정보가 포함된 KSSTREAM_SEGMENT 구조체에 대한 포인터입니다.

반환 값

성공하면 NOERROR를 반환합니다. 그렇지 않으면 오류 코드를 반환합니다.

설명

KsCompleteIo 메서드는 할당된 메모리를 삭제하고, 미디어 샘플을 업데이트하고, 프록시에 대한 대기 항목 수를 감소합니다.

KsCompleteIo 메서드는 IKsInterfaceHandler::KsProcessMediaSamples 메서드가 KSSTREAM_SEGMENT 구조체의 IoOperation 멤버에서 완료한 I/O 작업의 형식을 결정해야 합니다. I/O 작업이 KSIOOPERATION 열거형 형식의 스트림(KsIoOperation_Read )에서 데이터를 읽는 경우 KsCompleteIo 는 출력 핀에서 연결된 입력 핀으로 샘플을 전달하기 위해 다음 작업을 수행합니다.

IMediaSample 인터페이스의 스트림 헤더 정보를 반영합니다.
출력 핀의 IKsPin::KsDeliver 메서드를 호출하여 샘플을 배달합니다. KsDeliver 는 디바이스에 버퍼를 큐에 대기할 때 마지막 샘플인 경우 샘플을 검색할 수 있도록 샘플을 릴리스합니다. 그런 다음 입력 핀이 I/O를 완료하고 샘플을 해제해도 안전합니다.

IMediaSample에 대한 자세한 내용은 Microsoft Windows SDK 설명서를 참조하세요.