KSQUERYBUFFER 구조체(ks.h)
KSQUERYBUFFER 구조는 KSEVENT_TYPE_QUERYBUFFER 있는 이벤트에서 사용할 수 있는 미해결 버퍼를 쿼리할 때 사용됩니다.
구문
typedef struct {
KSEVENT Event;
PKSEVENTDATA EventData;
PVOID Reserved;
} KSQUERYBUFFER, *PKSQUERYBUFFER;
멤버
Event
KSEVENT_TYPE_ENABLEBUFFERED 플래그 대신 KSEVENT_TYPE_QUERYBUFFER 플래그가 설정된 원래 이벤트에 대한 설명을 지정합니다.
EventData
KSEVENTDATA 구조체에 대한 포인터입니다. 이벤트 사용 시 AVStrMiniAddEvent 에 제공된 것과 동일한 포인터입니다. 이 포인터는 이벤트를 비활성화할 때 사용되는 것처럼 이벤트를 찾는 데 고유한 식별자로 사용됩니다.
Reserved
사용되지 않고 0으로 설정합니다.
설명
KSEVENT_TYPE_ENABLEBUFFERED 사용하여 데이터를 버퍼링하는 이벤트를 사용하도록 설정한 경우 이 메서드를 사용하여 이벤트에서 생성된 데이터를 쿼리할 수 있습니다. 쿼리되는 이벤트에 대한 설명은 첫 번째 매개 변수로 제공되며 모든 버퍼는 쿼리의 두 번째 매개 변수로 제공됩니다.
필요한 버퍼 길이는 길이가 0인 출력 버퍼를 제공하여 쿼리할 수 있습니다. 버퍼의 크기는 STATUS_BUFFER_OVERFLOW 경고 상태 BytesReturned 매개 변수에 반환됩니다.
또는 쿼리는 다음 상태 값 중 하나를 반환합니다.
반환 값 | 설명 |
---|---|
STATUS_NOT_FOUND | 이벤트를 찾을 수 없습니다. |
STATUS_INVALID_PARAMETER | 버퍼링되지 않았습니다. |
STATUS_NO_MORE_ENTRIES | 버퍼를 사용할 수 없음 |
STATUS_BUFFER_TOO_SMALL | 버퍼 크기가 부족했습니다. |
STATUS_SUCCESS | 인생은 좋다. |
요구 사항
요구 사항 | 값 |
---|---|
헤더 | ks.h(Ks.h 포함) |