KsPinGetLeadingEdgeStreamPointer 함수(ks.h)
KsPinGetLeadingEdgeStreamPointer 함수는 지정된 핀과 연결된 큐에 대한 선행 에지 스트림 포인터를 가져옵니다.
구문
KSDDKAPI PKSSTREAM_POINTER KsPinGetLeadingEdgeStreamPointer(
[in] PKSPIN Pin,
[in] KSSTREAM_POINTER_STATE State
);
매개 변수
[in] Pin
선행 에지 스트림 포인터를 획득해야 하는 큐를 소유하는 KSPIN 구조체에 대한 포인터입니다.
[in] State
이 매개 변수는 선행 에지 스트림 포인터를 가져오는 방법을 지정합니다. 다음 중 하나일 수 있습니다.
KSSTREAM_POINTER_STATE_UNLOCKED
데이터 프레임을 참조하는지 여부에 관계없이 선행 에지 스트림 포인터를 가져옵니다.
포인터가 잠기기 전까지는 포인터와 연결된 데이터에 액세스하려고 시도할 수 없습니다. 또한 잠금 해제된 스트림 포인터와 연결된 프레임을 취소할 수 있습니다.
KSSTREAM_POINTER_STATE_LOCKED
선행 에지 스트림 포인터를 획득하고 잠급 수 있습니다. 스트림 포인터와 연결된 데이터 프레임이 없으면 NULL을 반환합니다. null이 아닌 포인터가 반환되면 잠긴 스트림 포인터이며 연결된 데이터 프레임이 있습니다. 잠긴 스트림 포인터와 연결된 프레임은 취소할 수 없습니다 .
반환 값
KsPinGetLeadingEdgeStreamPointer 는 KSSTREAM_POINTER 구조체 또는 NULL에 대한 포인터를 반환합니다. 핀과 연결된 큐가 없으므로 핀이 표준 전송 메커니즘을 사용하지 않음을 나타내는 NULL 반환 값이 발생할 수 있습니다. 또는 선행 에지를 잠그려는 시도가 실패하여 선행 에지와 연결된 데이터 프레임이 없음을 나타내는 NULL 반환 값이 발생할 수 있습니다.
설명
핀 중심 처리를 구현하는 필터는 종종 KsPinGetLeadingEdgeStreamPointer를 호출합니다.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 지원되는 최소 클라이언트 | Microsoft Windows XP 이상 운영 체제 및 DirectX 8.0 이상 DirectX 버전에서 사용할 수 있습니다. |
| 대상 플랫폼 | 유니버설 |
| 헤더 | ks.h(Ks.h 포함) |
| 라이브러리 | Ks.lib |
| IRQL | <=DISPATCH_LEVEL |
추가 정보
KsPinGetTrailingEdgeStreamPointer