Struktur KSQUERYBUFFER (ks.h)

  • Artikel

Struktur KSQUERYBUFFER digunakan saat mengkueri buffer luar biasa yang tersedia pada peristiwa dengan KSEVENT_TYPE_QUERYBUFFER.

Sintaks

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

Anggota

Event

Menentukan deskripsi peristiwa asli, dengan bendera KSEVENT_TYPE_QUERYBUFFER diatur alih-alih bendera KSEVENT_TYPE_ENABLEBUFFERED .

EventData

Pointer ke struktur KSEVENTDATA . Ini adalah pointer yang sama yang disediakan untuk AVStrMiniAddEvent pada waktu pengaktifan peristiwa. Pointer ini digunakan sebagai pengidentifikasi unik dalam menemukan peristiwa, sama seperti yang digunakan saat menonaktifkan peristiwa.

Reserved

Tidak digunakan, dan atur ke nol.

Keterangan

Jika KSEVENT_TYPE_ENABLEBUFFERED digunakan untuk mengaktifkan peristiwa yang juga menyangga data, maka data yang dihasilkan oleh peristiwa dapat dikueri menggunakan metode ini. Deskripsi peristiwa yang dikueri disediakan sebagai parameter pertama, dan buffer apa pun disediakan sebagai parameter kedua untuk kueri.

Panjang buffer yang diperlukan dapat dikueri dengan menyediakan buffer output panjang nol. Ukuran buffer dikembalikan dalam parameter BytesReturned , dengan status peringatan STATUS_BUFFER_OVERFLOW.

Atau, kueri mengembalikan salah satu nilai status berikut:

Tampilkan Nilai Deskripsi
STATUS_NOT_FOUND peristiwa tidak ditemukan
STATUS_INVALID_PARAMETER itu tidak sedang di-buffer
STATUS_NO_MORE_ENTRIES tidak ada buffer yang tersedia
STATUS_BUFFER_TOO_SMALL ukuran buffer tidak cukup.
STATUS_SUCCESS hidup itu baik.

Persyaratan

Persyaratan Nilai
Header ks.h (termasuk Ks.h)

Lihat juga

KSBUFFER_ITEM

KSEVENT