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 포함)

추가 정보

KSBUFFER_ITEM

KSEVENT