KSPIN_DISPATCH 结构 (ks.h)
KSPIN_DISPATCH 结构描述了客户端可以注册的回调,以便接收 pin 事件的通知。
语法
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) ,将 KSPIN 的 DeviceState 成员的值与KSSTATE_RUN进行比较不是执行此操作的可靠方法。 DeviceState 是指引脚已发出信号进入的状态,而不是管道。 若要可靠地执行上述操作,请在此结构的 SetDeviceState 回调中创建一个变量,然后检查此变量进行确定。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 在 Microsoft Windows XP 及更高版本的操作系统以及 Microsoft DirectX 8.0 及更高版本中可用。 |
标头 | ks.h (包括 Ks.h) |