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_RUNDeviceState 成员的值不是执行此作的可靠方法。 DeviceState 是指引脚已信号进入的状态,而不是管道。 若要可靠地执行上述作,请在 SetDeviceState 此结构的回调中创建变量,然后检查此变量以做出确定。

要求

要求 价值
最低支持的客户端 在 Microsoft Windows XP 及更高版本的作系统和 Microsoft DirectX 8.0 及更高版本中提供。
标头 ks.h (包括 Ks.h)

另请参阅

KSALLOCATOR_DISPATCH

KSCLOCK_DISPATCH

KSPIN

KsCompletePendingRequest