共用方式為


kSQUERYBUFFER 結構 (ks.h)

在查詢具有KSEVENT_TYPE_QUERYBUFFER的事件上可用的未處理緩衝區時,會使用 KSQUERYBUFFER 結構。

語法

typedef struct {
  KSEVENT      Event;
  PKSEVENTDATA EventData;
  PVOID        Reserved;
} KSQUERYBUFFER, *PKSQUERYBUFFER;

成員

Event

指定原始事件的描述,其中已設定 KSEVENT_TYPE_QUERYBUFFER 旗標,而不是 KSEVENT_TYPE_ENABLEBUFFERED 旗標。

EventData

KSEVENTDATA 結構的指標。 這是在事件啟用時提供給 AVStrMiniAddEvent 的相同指標。 此指標會當做尋找事件的唯一標識碼使用,就像停用事件時一樣。

Reserved

未使用,並將 設定為零。

備註

如果使用 KSEVENT_TYPE_ENABLEBUFFERED 來啟用也緩衝處理數據的事件,則可以使用此方法查詢事件所產生的數據。 所查詢事件的描述會以第一個參數的形式提供,而任何緩衝區會提供為查詢的第二個參數。

您可以藉由提供零長度輸出緩衝區來查詢所需的緩衝區長度。 緩衝區的大小會在 BytesReturned 參數中傳回,且警告狀態為 STATUS_BUFFER_OVERFLOW

或者,查詢會傳回下列其中一個狀態值:

傳回值 描述
STATUS_NOT_FOUND 找不到事件
STATUS_INVALID_PARAMETER 未緩衝處理
STATUS_NO_MORE_ENTRIES 沒有可用的緩衝區
STATUS_BUFFER_TOO_SMALL 緩衝區大小不足。
STATUS_SUCCESS 生活很好。

規格需求

需求
標頭 ks.h (包含 Ks.h)

另請參閱

KSBUFFER_ITEM

KSEVENT