struktur KSPIN_DISPATCH (ks.h)
Struktur KSPIN_DISPATCH menjelaskan panggilan balik yang dapat didaftarkan klien untuk menerima pemberitahuan peristiwa pin.
Sintaks
typedef struct _KSPIN_DISPATCH {
PFNKSPINIRP Create;
PFNKSPINIRP Close;
PFNKSPIN Process;
PFNKSPINVOID Reset;
PFNKSPINSETDATAFORMAT SetDataFormat;
PFNKSPINSETDEVICESTATE SetDeviceState;
PFNKSPIN Connect;
PFNKSPINVOID Disconnect;
const KSCLOCK_DISPATCH *Clock;
const KSALLOCATOR_DISPATCH *Allocator;
} KSPIN_DISPATCH, *PKSPIN_DISPATCH;
Anggota
Create
Penunjuk ke rutinitas panggilan balik AVStrMiniPinCreate yang disediakan minidriver. Pilihan. Bisa NULL.
Close
Penunjuk ke rutinitas panggilan balik AVStrMiniPinClose yang disediakan minidriver. Pilihan. Bisa NULL.
Process
Penunjuk ke rutinitas panggilan balik AVStrMiniPinProcess yang disediakan minidriver. Pilihan. Bisa NULL.
Reset
Penunjuk ke rutinitas panggilan balik AVStrMiniPinReset yang disediakan minidriver. Opsional. Bisa NULL.
SetDataFormat
Penunjuk ke rutinitas panggilan balik AVStrMiniPinSetDataFormat yang disediakan minidriver. Pilihan. Bisa NULL.
SetDeviceState
Penunjuk ke rutinitas panggilan balik AVStrMiniPinSetDeviceState yang disediakan minidriver. Pilihan. Bisa NULL.
Connect
Penunjuk ke rutinitas panggilan balik AVStrMiniPinConnect yang disediakan minidriver. Pilihan. Bisa NULL.
Disconnect
Penunjuk ke rutinitas panggilan balik AVStrMiniPinDisconnect yang disediakan minidriver. Pilihan. Bisa NULL.
Clock
Penunjuk ke struktur KSCLOCK_DISPATCH . Tentukan anggota ini untuk pin yang mengekspos jam. Pilihan. Bisa NULL.
Allocator
Penunjuk ke struktur KSALLOCATOR_DISPATCH . Tentukan anggota ini untuk pin yang mampu melakukan alokasi tingkat kernel. Pilihan. Bisa NULL.
Keterangan
Salah satu penunjuk panggilan balik dapat berupa NULL, yang menunjukkan bahwa minidriver tidak perlu menerima pemberitahuan untuk pengiriman khusus ini.
Jika minidriver perlu menentukan apakah telah disinyalkan untuk pergi ke status tertentu (misalnya KSSTATE_RUN), membandingkan nilai anggota DeviceStateKSPIN dengan KSSTATE_RUN bukanlah metode yang dapat diandalkan untuk melakukan ini. DeviceState mengacu pada status di mana pin telah diberi sinyal untuk pergi, bukan pipa. Untuk melakukan hal di atas dengan andal, sebagai gantinya buat variabel dalam panggilan balik SetDeviceState dari struktur ini dan kemudian periksa variabel ini untuk membuat penentuan.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Tersedia di Microsoft Windows XP dan sistem operasi yang lebih baru dan di Microsoft DirectX 8.0 dan versi yang lebih baru. |
Header | ks.h (termasuk Ks.h) |