DirectShow DirectShow 레퍼런스 인터페이스 IAsyncReader SyncRead [목차열람] [주소복사] [슬롯비우기] |
Microsoft DirectX 9.0 |
SyncRead 메서드는, 동기 읽기를 실행한다. 메서드는, 요구가 완료할 때까지 블록 한다. 파일의 위치와 버퍼 주소는, alignment 할 필요는 없다. 요구가 alignment되지 않은 경우, 메서드는 버퍼링 된 읽기 처리를 실행한다.
구문
HRESULT SyncRead(
LONGLONG llPosition,
LONG lLength,
BYTE *pBuffer
);
파라미터
llPosition
[in] 읽기를 시작 하는 바이트 오프셋(offset)를 지정한다. 값이 파일의 말미를 넘으면 메서드는 실패한다.
lLength
[in] 읽어내는 바이트수를 지정한다.
pBuffer
[out] 데이터를 받는 버퍼의 포인터.
반환값
HRESULT 값을 돌려준다. 가능한 값은 다음과 같다.
반환 코드 | 설명 |
S_FALSE | 취득한 바이트의 수가 요구된 바이트의 수보다 적다 (파일의 말미에 이르렀다고 생각된다). |
S_OK | 성공. |
주의
이 메서드는, 필터가 정지하고 있어도 동작한다.
참조