Compartilhar via


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)

Confira também

KSALLOCATOR_DISPATCH

KSCLOCK_DISPATCH

KSPIN

KsCompletePendingRequest