estrutura KSDEVICE_DISPATCH (ks.h)

Artigo
02/07/2025

A estrutura KSDEVICE_DISPATCH descreve os retornos de chamada que um cliente pode fornecer para receber notificação de criação de dispositivo e eventos PnP.

Sintaxe

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;

Membros

Add

Opcional. Pode ser NULL. Um ponteiro para um minidriver fornecido AVStrMiniDeviceAdd rotina de retorno de chamada.

Start

Opcional. Pode ser NULL. Um ponteiro para um minidriver fornecido AVStrMiniDeviceStart rotina de retorno de chamada.

PostStart

Opcional. Pode ser NULL. Um ponteiro para um minidriver fornecido AVStrMiniDevicePostStart rotina de retorno de chamada.

QueryStop

Opcional. Pode ser NULL. Um ponteiro para um minidriver fornecido AVStrMiniDeviceQueryStop rotina de retorno de chamada.

CancelStop

Opcional. Pode ser NULL. Um ponteiro para um minidriver fornecido AVStrMiniDeviceCancelStop rotina de retorno de chamada.

Stop

Opcional. Pode ser NULL. Um ponteiro para um minidriver fornecido AVStrMiniDeviceStop rotina de retorno de chamada.

QueryRemove

Opcional. Pode ser NULL. Um ponteiro para um minidriver fornecido AVStrMiniDeviceQueryRemove rotina de retorno de chamada.

CancelRemove

Opcional. Pode ser NULL. Um ponteiro para um minidriver fornecido AVStrMiniDeviceCancelRemove rotina de retorno de chamada.

Remove

Opcional. Pode ser NULL. Um ponteiro para um minidriver fornecido AVStrMiniDeviceRemove rotina de retorno de chamada.

QueryCapabilities

Opcional. Pode ser NULL. Um ponteiro para um minidriver fornecido AVStrMiniDeviceQueryCapabilities rotina de retorno de chamada.

SurpriseRemoval

Opcional. Pode ser NULL. Um ponteiro para um minidriver fornecido AVStrMiniDeviceSurpriseRemoval rotina de retorno de chamada.

QueryPower

Opcional. pode ser NULL. Um ponteiro para um minidriver fornecido AVStrMiniDeviceQueryPower rotina de retorno de chamada.

SetPower

Opcional. Pode ser NULL. Um ponteiro para um minidriver fornecido AVStrMiniDeviceSetPower rotina de retorno de chamada.

QueryInterface

Opcional. Pode ser NULL. Um ponteiro para um minidriver fornecido AVStrMiniDeviceQueryInterface rotina de retorno de chamada.

Observações

Ao descrever um dispositivo com a estrutura KSDEVICE_DESCRIPTOR, os clientes incluem um ponteiro para uma tabela de expedição definida por essa estrutura. Qualquer membro dessa estrutura pode ser NULL indicando que o minidriver não recebe nenhuma notificação para essa mensagem específica.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no Microsoft DirectX 8.0 e versões posteriores.
cabeçalho	ks.h (incluir Ks.h)

Consulte também

KSDEVICE_DESCRIPTOR

Compartilhar via