структура KSDEVICE_DISPATCH (ks.h)

Статья
02/07/2025

Структура 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. Указатель на подпрограмму обратного вызова, предоставленного мини-driver, AVStrMiniDeviceAdd.

Start

Необязательный. Может быть значение NULL. Указатель на предоставленный мини-driver AVStrMiniDeviceStart подпрограмме обратного вызова.

PostStart

Необязательный. Может быть значение NULL. Указатель на подпрограмму обратного вызова, предоставленного мини-driver, AVStrMiniDevicePostStart.

QueryStop

Необязательный. Может быть значение NULL. Указатель на подпрограмму обратного вызова, предоставленного мини-driver, AVStrMiniDeviceQueryStop.

CancelStop

Необязательный. Может быть значение NULL. Указатель на подпрограмму обратного вызова, предоставленного мини-driver, AVStrMiniDeviceCancelStop.

Stop

Необязательный. Может быть значение NULL. Указатель на подпрограмму обратного вызова, предоставленного мини-driver, AVStrMiniDeviceStop.

QueryRemove

Необязательный. Может быть значение NULL. Указатель на подпрограмму обратного вызова, предоставленного мини-driver, AVStrMiniDeviceQueryRemove.

CancelRemove

Необязательный. Может быть значение NULL. Указатель на подпрограмму обратного вызова, предоставленного мини-driver, AVStrMiniDeviceCancelRemove.

Remove

Необязательный. Может быть значение NULL. Указатель на подпрограмму обратного вызова, предоставленного мини-driver, AVStrMiniDeviceRemove.

QueryCapabilities

Необязательный. Может быть значение NULL. Указатель на предоставленный мини-driver AVStrMiniDeviceQueryCapabilities подпрограмме обратного вызова.

SurpriseRemoval

Необязательный. Может быть значение NULL. Указатель на подпрограмму обратного вызова, предоставленного мини-driver, AVStrMiniDeviceSurpriseRemoval.

QueryPower

Необязательный. может быть значение NULL. Указатель на подпрограмму обратного вызова avStrMiniDevice QueryPower, предоставленного мини-driver,.

SetPower

Необязательный. Может быть значение NULL. Указатель на подпрограмму обратного вызова, предоставленного мини-driver, AVStrMiniDeviceSetPower.

QueryInterface

Необязательный. Может быть значение NULL. Указатель на подпрограмму обратного вызова, предоставленного мини-driver, AVStrMiniDeviceQueryInterface.

Замечания

В описании устройства со структурой KSDEVICE_DESCRIPTOR клиенты включают указатель на таблицу отправки, определенную этой структурой. Любой элемент этой структуры может быть null, указывающий, что мини-driver не получает уведомления об этом конкретном сообщении.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Доступно в Операционных системах Microsoft Windows XP и более поздних версиях, а также в Microsoft DirectX 8.0 и более поздних версиях.
заголовка	ks.h (include Ks.h)

См. также

KSDEVICE_DESCRIPTOR

Поделиться через