次の方法で共有

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 を使用してデータもバッファーするイベントを有効にした場合、イベントによって生成されたデータは、このメソッドを使用してクエリを実行できます。 クエリ対象のイベントの説明が最初のパラメーターとして提供され、すべてのバッファーがクエリの 2 番目のパラメーターとして提供されます。

必要なバッファー長を照会するには、長さ 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をする