Função KsPinGetLeadingEdgeStreamPointer (ks.h)
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 |
Confira também
KsPinGetTrailingEdgeStreamPointer