KSDEVICE_DISPATCH-Struktur (ks.h)

Die KSDEVICE_DISPATCH-Struktur beschreibt die Rückrufe, die ein Client bereitstellen kann, um Benachrichtigungen über Geräteerstellungs- und PnP-Ereignisse zu erhalten.

Syntax

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;

Member

Add

Optional. Kann NULL sein. Ein Zeiger auf eine von Minidriver bereitgestellte AVStrMiniDeviceAdd-Rückrufroutine .

Start

Optional. Kann NULL sein. Ein Zeiger auf eine von minidriver bereitgestellte AVStrMiniDeviceStart-Rückrufroutine .

PostStart

Optional. Kann NULL sein. Ein Zeiger auf eine von Minidriver bereitgestellte AVStrMiniDevicePostStart-Rückrufroutine .

QueryStop

Optional. Kann NULL sein. Ein Zeiger auf eine von Minidriver bereitgestellte AVStrMiniDeviceQueryStop-Rückrufroutine .

CancelStop

Optional. Kann NULL sein. Ein Zeiger auf eine von Minidriver bereitgestellte AVStrMiniDeviceCancelStop-Rückrufroutine .

Stop

Optional. Kann NULL sein. Ein Zeiger auf eine von Minidriver bereitgestellte AVStrMiniDeviceStop-Rückrufroutine .

QueryRemove

Optional. Kann NULL sein. Ein Zeiger auf eine von Minidriver bereitgestellte AVStrMiniDeviceQueryRemove-Rückrufroutine .

CancelRemove

Optional. Kann NULL sein. Ein Zeiger auf eine von Minidriver bereitgestellte AVStrMiniDeviceCancelRemove-Rückrufroutine .

Remove

Optional. Kann NULL sein. Ein Zeiger auf eine von Minidriver bereitgestellte AVStrMiniDeviceRemove-Rückrufroutine .

QueryCapabilities

Optional. Kann NULL sein. Ein Zeiger auf eine von Minidriver bereitgestellte AVStrMiniDeviceQueryCapabilities-Rückrufroutine .

SurpriseRemoval

Optional. Kann NULL sein. Ein Zeiger auf eine von Minidriver bereitgestellte AVStrMiniDeviceSurpriseRemoval-Rückrufroutine .

QueryPower

Optional. kann NULL sein. Ein Zeiger auf eine von Minidriver bereitgestellte AVStrMiniDeviceQueryPower-Rückrufroutine .

SetPower

Optional. Kann NULL sein. Ein Zeiger auf eine von Minidriver bereitgestellte AVStrMiniDeviceSetPower-Rückrufroutine .

QueryInterface

Optional. Kann NULL sein. Ein Zeiger auf eine von Minidriver bereitgestellte AVStrMiniDeviceQueryInterface-Rückrufroutine .

Hinweise

Bei der Beschreibung eines Geräts mit der KSDEVICE_DESCRIPTOR-Struktur enthalten Clients einen Zeiger auf eine durch diese Struktur definierte Dispatchtabelle. Jeder Member dieser Struktur kann NULL sein, was angibt, dass der Minitreiber keine Benachrichtigung für diese bestimmte Nachricht empfängt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Verfügbar in Microsoft Windows XP und höheren Betriebssystemen sowie in Microsoft DirectX 8.0 und höheren Versionen.
Kopfzeile	ks.h (ks.h einschließen)

Weitere Informationen

KSDEVICE_DESCRIPTOR