KSDEVICE_DISPATCH 结构 (ks.h)

KSDEVICE_DISPATCH结构描述了客户端可以提供的回调，以接收设备创建和 PnP 事件的通知。

语法

typedef struct _KSDEVICE_DISPATCH {
  PFNKSDEVICECREATE            Add;
  PFNKSDEVICEPNPSTART          Start;
  PFNKSDEVICE                  PostStart;
  PFNKSDEVICEIRP               QueryStop;
  PFNKSDEVICEIRPVOID           CancelStop;
  PFNKSDEVICEIRPVOID           Stop;
  PFNKSDEVICEIRP               QueryRemove;
  PFNKSDEVICEIRPVOID           CancelRemove;
  PFNKSDEVICEIRPVOID           Remove;
  PFNKSDEVICEQUERYCAPABILITIES QueryCapabilities;
  PFNKSDEVICEIRPVOID           SurpriseRemoval;
  PFNKSDEVICEQUERYPOWER        QueryPower;
  PFNKSDEVICESETPOWER          SetPower;
  PFNKSDEVICEIRP               QueryInterface;
} KSDEVICE_DISPATCH, *PKSDEVICE_DISPATCH;

成员

Add

可选。 可以为 NULL。 指向微型驱动程序提供的 AVStrMiniDeviceAdd 回调例程的指针。

Start

可选。 可以为 NULL。 指向微型驱动程序提供的 AVStrMiniDeviceStart 回调例程的指针。

PostStart

可选。 可以为 NULL。 指向微型驱动程序提供的 AVStrMiniDevicePostStart 回调例程的指针。

QueryStop

可选。 可以为 NULL。 指向微型驱动程序提供的 AVStrMiniDeviceQueryStop 回调例程的指针。

CancelStop

可选。 可以为 NULL。 指向微型驱动程序提供的 AVStrMiniDeviceCancelStop 回调例程的指针。

Stop

可选。 可以为 NULL。 指向微型驱动程序提供的 AVStrMiniDeviceStop 回调例程的指针。

QueryRemove

可选。 可以为 NULL。 指向微型驱动程序提供的 AVStrMiniDeviceQueryRemove 回调例程的指针。

CancelRemove

可选。 可以为 NULL。 指向微型驱动程序提供的 AVStrMiniDeviceCancelRemove 回调例程的指针。

Remove

可选。 可以为 NULL。 指向微型驱动程序提供的 AVStrMiniDeviceRemove 回调例程的指针。

QueryCapabilities

可选。 可以为 NULL。 指向微型驱动程序提供的 AVStrMiniDeviceQueryCapabilities 回调例程的指针。

SurpriseRemoval

可选。 可以为 NULL。 指向微型驱动程序提供的 AVStrMiniDeviceSurpriseRemoval 回调例程的指针。

QueryPower

可选。 可以为 NULL。 指向微型驱动程序提供的 AVStrMiniDeviceQueryPower 回调例程的指针。

SetPower

可选。 可以为 NULL。 指向微型驱动程序提供的 AVStrMiniDeviceSetPower 回调例程的指针。

QueryInterface

可选。 可以为 NULL。 指向微型驱动程序提供的 AVStrMiniDeviceQueryInterface 回调例程的指针。

注解

在描述具有 KSDEVICE_DESCRIPTOR 结构的设备时，客户端包含指向此结构定义的调度表的指针。 此结构的任何成员都可以为 NULL ，指示微型驱动程序未收到该特定消息的通知。

要求

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

另请参阅

KSDEVICE_DESCRIPTOR