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

要求

要求
最低受支持的客户端 在 Microsoft Windows XP 及更高版本的操作系统以及 Microsoft DirectX 8.0 及更高版本中可用。
标头 ks.h (包括 Ks.h)

另请参阅

KSALLOCATOR_DISPATCH

KSCLOCK_DISPATCH

KSPIN

KsCompletePendingRequest