KSPIN_DISPATCH结构 (ks.h)
KSPIN_DISPATCH结构描述客户端可以注册的回调,以便接收固定事件的通知。
语法
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;
成员
Create
指向微型驱动程序提供的 AVStrMiniPinCreate 回调例程的指针。 自选。 可以为 NULL 。
Close
指向微型驱动程序提供的 AVStrMiniPinClose 回调例程的指针。 自选。 可以为 NULL 。
Process
指向微型驱动程序提供的 AVStrMiniPinProcess 回调例程的指针。 自选。 可以为 NULL 。
Reset
指向微型驱动程序提供的 AVStrMiniPinReset 回调例程的指针。 自选。 可以为 NULL 。
SetDataFormat
指向微型驱动程序提供的 AVStrMiniPinSetDataFormat 回调例程的指针。 自选。 可以为 NULL 。
SetDeviceState
指向微型驱动程序提供的 AVStrMiniPinSetDeviceState 回调例程的指针。 自选。 可以为 NULL 。
Connect
指向提供 AVStrMiniPinConnect 回调例程的微型驱动程序的指针。 自选。 可以为 NULL 。
Disconnect
指向提供 AVStrMiniPinDisconnect 回调例程的微型驱动程序的指针。 自选。 可以为 NULL 。
Clock
指向 KSCLOCK_DISPATCH 结构的指针。 为公开时钟的引脚指定此成员。 自选。 可以为 NULL 。
Allocator
指向 KSALLOCATOR_DISPATCH 结构的指针。 为能够执行内核级分配的引脚指定此成员。 自选。 可以为 NULL 。
言论
任何回调指针都可以 NULL,指示微型驱动程序不需要接收此特定调度的通知。
如果微型驱动程序需要确定它是否已信号转到特定状态(例如KSSTATE_RUN),则比较 KSPINKSSTATE_RUN 的 DeviceState 成员的值不是执行此作的可靠方法。 DeviceState 是指引脚已信号进入的状态,而不是管道。 若要可靠地执行上述作,请在 SetDeviceState 此结构的回调中创建变量,然后检查此变量以做出确定。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | 在 Microsoft Windows XP 及更高版本的作系统和 Microsoft DirectX 8.0 及更高版本中提供。 |
标头 | ks.h (包括 Ks.h) |