struttura KSDEVICE_DISPATCH (ks.h)

Articolo
02/07/2025

La struttura KSDEVICE_DISPATCH descrive i callback che un client può fornire per ricevere la notifica degli eventi di creazione e PnP del dispositivo.

Sintassi

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;

Membri

Add

Opzionale. Può essere NULL. Puntatore a un minidriver fornito AVStrMiniDeviceAdd routine di callback.

Start

Opzionale. Può essere NULL. Puntatore a un minidriver fornito AVStrMiniDeviceStart routine di callback.

PostStart

Opzionale. Può essere NULL. Puntatore a un minidriver fornito AVStrMiniDevicePostStart routine di callback.

QueryStop

Opzionale. Può essere NULL. Puntatore a un minidriver fornito AVStrMiniDeviceQueryStop routine di callback.

CancelStop

Opzionale. Può essere NULL. Puntatore a un minidriver fornito AVStrMiniDeviceCancelStop routine di callback.

Stop

Opzionale. Può essere NULL. Puntatore a un minidriver fornito AVStrMiniDeviceStop routine di callback.

QueryRemove

Opzionale. Può essere NULL. Puntatore a un minidriver fornito AVStrMiniDeviceQueryRemove routine di callback.

CancelRemove

Opzionale. Può essere NULL. Puntatore a un minidriver fornito AVStrMiniDeviceCancelRemove routine di callback.

Remove

Opzionale. Può essere NULL. Puntatore a un minidriver fornito AVStrMiniDeviceRemove routine di callback.

QueryCapabilities

Opzionale. Può essere NULL. Puntatore a un minidriver fornito AVStrMiniDeviceQueryCapabilities routine di callback.

SurpriseRemoval

Opzionale. Può essere NULL. Puntatore a un minidriver fornito AVStrMiniDeviceSurpriseRemoval routine di callback.

QueryPower

Opzionale. può essere NULL. Puntatore a un minidriver fornito AVStrMiniDeviceQueryPower routine di callback.

SetPower

Opzionale. Può essere NULL. Puntatore a un minidriver fornito AVStrMiniDeviceSetPower routine di callback.

QueryInterface

Opzionale. Può essere NULL. Puntatore a un minidriver fornito AVStrMiniDeviceQueryInterface routine di callback.

Osservazioni

Nella descrizione di un dispositivo con la struttura KSDEVICE_DESCRIPTOR, i client includono un puntatore a una tabella dispatch definita da questa struttura. Qualsiasi membro di questa struttura può essere NULL che indica che il minidriver non riceve alcuna notifica per quel particolare messaggio.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Microsoft Windows XP e nei sistemi operativi successivi e in Microsoft DirectX 8.0 e versioni successive.
intestazione	ks.h (include Ks.h)

Vedere anche

KSDEVICE_DESCRIPTOR

Condividi tramite