Estrutura KSPROCESSPIN (ks.h)

A estrutura KSPROCESSPIN descreve o estado do processo de um pin específico.

Sintaxe

typedef struct _KSPROCESSPIN {
  PKSPIN            Pin;
  PKSSTREAM_POINTER StreamPointer;
  PKSPROCESSPIN     InPlaceCounterpart;
  PKSPROCESSPIN     DelegateBranch;
  PKSPROCESSPIN     CopySource;
  PVOID             Data;
  ULONG             BytesAvailable;
  ULONG             BytesUsed;
  ULONG             Flags;
  BOOLEAN           Terminate;
} KSPROCESSPIN, *PKSPROCESSPIN;

Membros

Pin

Um ponteiro para uma estrutura KSPIN que a estrutura KSPROCESSPIN está descrevendo. Tudo na estrutura refere-se a este KSPIN.

StreamPointer

Um ponteiro para uma estrutura KSSTREAM_POINTER que aponta para o fluxo de entrada no local de entrada atual ou no fluxo de saída no local de saída atual. Isso pode ser usado, por exemplo, por pinos de saída para carimbar informações no KSSTREAM_HEADER associado (ProcessPin-StreamPointer-StreamHeader-Flags>>>=...).

InPlaceCounterpart

Um ponteiro para uma estrutura KSPROCESSPIN. Se esse KSPROCESSPIN não fizer parte de uma transformação inplace , o AVStream definirá InPlaceCounterpart como NULL. Se esse KSPROCESSPIN for a entrada para uma transformação inplace, InPlaceCounterpart apontará para o pin do processo de saída para a transformação. Se esse KSPROCESSPIN for a saída de uma transformação inplace, InPlaceCounterpart apontará para o pin do processo de entrada para a transformação.

DelegateBranch

Um ponteiro para uma estrutura KSPROCESSPIN. Se os quadros que saem desse KSPROCESSPIN estiverem sendo divididos e enviados para vários pinos de coletor e a divisão não causar uma cópia de dados (ou seja, a divisão enviará os quadros de maneira somente leitura e todas as instâncias de pino dividido estiverem no mesmo pipe), DelegateBranch apontará para a primeira instância do pin do processo. O divisor manipula automaticamente qualquer pin de processo que tenha um DelegateBranch não NULL.

CopySource

Um ponteiro para uma estrutura KSPROCESSPIN. Se os quadros que saem desse pin de processo estiverem sendo divididos e enviados para vários pinos de coletor de uma maneira que cause uma cópia de dados (ou seja, um dos filtros downstream está modificando o quadro de dados usando uma transformação in-loco), CopySource aponta para o pin de processo do qual o quadro foi copiado. O divisor manipula automaticamente qualquer pin de processo que tenha um CopySource não NULL.

Data

Um ponteiro para um buffer. Se o pin descrito por essa entrada de processo for um pin de entrada, Os dados apontarão para o próximo byte disponível de dados a serem inseridos. Se o pin descrito por essa entrada de processo for um pino de saída, os dados apontarão para um buffer de saída no qual os dados processados são colocados.

BytesAvailable

Esse membro especifica quantos bytes de dados estão disponíveis em Dados.

BytesUsed

Esse membro especifica quantos bytes desse quadro de dados foram usados pela função de processo. Os drivers AVStream devem definir esse membro para atualizar o quanto eles leram ou gravaram.

Flags

Esse membro contém uma cópia dos sinalizadores da estrutura de KSSTREAM_HEADER relevante, se esse KSPROCESSPIN for um pin de entrada.

Terminate

Esse membro indica se o quadro de dados atual deve ser enviado downstream após a conclusão da expedição do processo. Se TRUE, o quadro será enviado downstream mesmo se todos os dados não tiverem sido consumidos. Se FALSE, o quadro não será liberado até que todos os dados sejam consumidos.

Comentários

A estrutura KSPROCESSPIN é usada no modelo de processamento centrado em filtro . Você pode usar essa estrutura para acessar dados em um pin de entrada específico ou para gravar dados processados em um pino de saída.

Somente clientes centrados em filtro usam pinos de processo. Além disso, os pinos de processo que têm um DelegateBranch não NULL ou um CopySource não NULL normalmente não são preocupantes para o cliente. O divisor manipula automaticamente os pinos de processo com esses ponteiros.

A maioria dos clientes está preocupada com os membros Pin, Data, BytesAvailable, BytesUsed, Flags e Terminate. Os dados podem ser lidos do fluxo ou gravados no fluxo por meio do membro Dados ; BytesAvailable informa ao cliente quantos bytes de dados estão disponíveis no quadro de dados atual (buffer) para o qual os dados apontam. À medida que o minidriver do cliente lê ou grava no fluxo, BytesUsed deve ser atualizado para refletir quantos bytes de dados foram consumidos. O sinalizador Terminate poderá ser definido se o minidriver for feito com o quadro atual, apesar do fato de que BytesUsed não é igual a BytesAvailable. Depois que o minidriver sair da expedição de processamento, os ponteiros serão avançados e os quadros serão concluídos conforme apropriado.

Requisitos

Confira também

KSPIN

KSPROCESSPIN_INDEXENTRY

KSSTREAM_HEADER

KSSTREAM_POINTER