Função KsPinGetLeadingEdgeStreamPointer (ks.h)
A função KsPinGetLeadingEdgeStreamPointer adquire o ponteiro de fluxo de borda superior 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 do fluxo de borda superior deve ser adquirido.
[in] State
Esse parâmetro especifica como adquirir o ponteiro de fluxo de borda à esquerda. Pode ser um dos seguintes:
KSSTREAM_POINTER_STATE_UNLOCKED
Adquira o ponteiro do fluxo de borda superior, independentemente de fazer referência a um quadro de dados ou não.
Nenhuma tentativa pode ser feita para acessar os dados associados ao ponteiro até que o ponteiro esteja 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 do fluxo de borda superior. Se nenhum quadro de dados estiver associado ao ponteiro de fluxo, retorne NULL. Se um ponteiro denão nulo for retornado, ele será um ponteiro de fluxo bloqueado e terá um quadro de dados associado a ele. Os quadros associados a um ponteiro de fluxo bloqueado não podem ser cancelados.
Valor de retorno
KsPinGetLeadingEdgeStreamPointer retorna um ponteiro para uma estrutura KSSTREAM_POINTER ou NULL. Um valor retornado de NULL pode ocorrer porque não há nenhuma 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 superior falhou, indicando que não há nenhum quadro de dados associado à borda superior.
Observações
Os filtros que implementam Pin-Centric Processamento geralmente chamam KsPinGetLeadingEdgeStreamPointer.
Requisitos
| Requisito | Valor |
|---|---|
| de cliente com suporte mínimo | Disponível no Microsoft Windows XP e em sistemas operacionais posteriores e no DirectX 8.0 e versões posteriores do DirectX. |
| da Plataforma de Destino | Universal |
| cabeçalho | ks.h (incluir Ks.h) |
| biblioteca | Ks.lib |
| IRQL | <=DISPATCH_LEVEL |
Consulte também
KsPinGetTrailingEdgeStreamPointer