estrutura KSPIN_DISPATCH (ks.h)
A estrutura KSPIN_DISPATCH descreve os retornos de chamada para os quais os clientes podem se registrar para receber notificação de eventos de pino.
Sintaxe
typedef struct _KSPIN_DISPATCH {
PFNKSPINIRP Create;
PFNKSPINIRP Close;
PFNKSPIN Process;
PFNKSPINVOID Reset;
PFNKSPINSETDATAFORMAT SetDataFormat;
PFNKSPINSETDEVICESTATE SetDeviceState;
PFNKSPIN Connect;
PFNKSPINVOID Disconnect;
const KSCLOCK_DISPATCH *Clock;
const KSALLOCATOR_DISPATCH *Allocator;
} KSPIN_DISPATCH, *PKSPIN_DISPATCH;
Membros
Create
Um ponteiro para uma rotina de retorno de chamada AVStrMiniPinCreate fornecida por minidriver. Opcional. Pode ser NULL.
Close
Um ponteiro para uma rotina de retorno de chamada AVStrMiniPinClose fornecida por minidriver. Opcional. Pode ser NULL.
Process
Um ponteiro para uma rotina de retorno de chamada AVStrMiniPinProcess fornecida por minidriver. Opcional. Pode ser NULL.
Reset
Um ponteiro para uma rotina de retorno de chamada AVStrMiniPinReset fornecida por minidriver. Opcional. Pode ser NULL.
SetDataFormat
Um ponteiro para uma rotina de retorno de chamada AVStrMiniPinSetDataFormat fornecida por minidriver. Opcional. Pode ser NULL.
SetDeviceState
Um ponteiro para uma rotina de retorno de chamada AVStrMiniPinSetDeviceState fornecida por minidriver. Opcional. Pode ser NULL.
Connect
Um ponteiro para uma rotina de retorno de chamada AVStrMiniPinConnect fornecida por minidriver. Opcional. Pode ser NULL.
Disconnect
Um ponteiro para uma rotina de retorno de chamada AVStrMiniPinDisconnect fornecida por minidriver. Opcional. Pode ser NULL.
Clock
Um ponteiro para uma estrutura KSCLOCK_DISPATCH . Especifique esse membro para um pino que expõe um relógio. Opcional. Pode ser NULL.
Allocator
Um ponteiro para uma estrutura KSALLOCATOR_DISPATCH . Especifique esse membro para um pin capaz de executar a alocação no nível do kernel. Opcional. Pode ser NULL.
Comentários
Qualquer um dos ponteiros de retorno de chamada pode ser NULL, indicando que o minidriver não precisa receber notificação para essa expedição específica.
Se o minidriver precisar determinar se ele foi sinalizado para ir para um estado específico (por exemplo, KSSTATE_RUN), comparar o valor do membro DeviceState de KSPIN com KSSTATE_RUN não é um método confiável de fazer isso. DeviceState refere-se ao estado para o qual o pino foi sinalizado para ir, não o pipe. Para executar o acima de forma confiável, crie uma variável no retorno de chamada SetDeviceState dessa estrutura e, em seguida, marcar essa variável para fazer a determinação.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | 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 (inclua Ks.h) |