Função KsPinGetLeadingEdgeStreamPointer (ks.h)

Artigo
03/05/2024

A função KsPinGetLeadingEdgeStreamPointer adquire o ponteiro de fluxo de borda à esquerda para a fila associada ao pin fornecido.

Sintaxe

KSDDKAPI PKSSTREAM_POINTER KsPinGetLeadingEdgeStreamPointer(
  [in] PKSPIN                 Pin,
  [in] KSSTREAM_POINTER_STATE State
);

Parâmetros

[in] Pin

Um ponteiro para a estrutura KSPIN que possui a fila para a qual o ponteiro de fluxo de borda à esquerda deve ser adquirido.

[in] State

Esse parâmetro especifica como adquirir o ponteiro de fluxo de borda à esquerda. Um dos seguintes pode ser feito:

KSSTREAM_POINTER_STATE_UNLOCKED

Adquira o ponteiro de fluxo de borda à esquerda, independentemente de ele referenciar um quadro de dados ou não.

Nenhuma tentativa pode ser feita para acessar os dados associados ao ponteiro até que o ponteiro seja bloqueado. Observe também que os quadros associados a um ponteiro de fluxo desbloqueado podem ser cancelados.

KSSTREAM_POINTER_STATE_LOCKED

Adquira e bloqueie o ponteiro de fluxo de borda à esquerda. Se nenhum quadro de dados estiver associado ao ponteiro de fluxo, retorne NULL. Se um ponteiro nãonulo for retornado, ele será um ponteiro de fluxo bloqueado e terá um quadro de dados associado a ele. Quadros associados a um ponteiro de fluxo bloqueado não podem ser cancelados.

Retornar valor

KsPinGetLeadingEdgeStreamPointer retorna um ponteiro para uma estrutura KSSTREAM_POINTER ou NULL. Um valor retornado de NULL pode ocorrer porque não há fila associada ao pino, indicando que o pino não usa o mecanismo de transporte padrão. Como alternativa, um valor retornado de NULL pode ocorrer porque uma tentativa de bloquear a borda à esquerda falhou, indicando que não há nenhum quadro de dados associado à borda à esquerda.

Comentários

Os filtros que implementam o processamento centrado em pin geralmente chamam KsPinGetLeadingEdgeStreamPointer.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX.
Plataforma de Destino	Universal
Cabeçalho	ks.h (inclua Ks.h)
Biblioteca	Ks.lib
IRQL	<=DISPATCH_LEVEL