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