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) |