Função KsStreamPointerLock (ks.h)
A função KsStreamPointerLock tenta bloquear o ponteiro de fluxo especificado.
Sintaxe
KSDDKAPI NTSTATUS KsStreamPointerLock(
[in] PKSSTREAM_POINTER StreamPointer
);
Parâmetros
[in] StreamPointer
Um ponteiro para uma estrutura KSSTREAM_POINTER que representa o ponteiro de fluxo para tentar bloquear.
Retornar valor
KsStreamPointerLock retorna STATUS_SUCCESS, indicando que o ponteiro de fluxo foi bloqueado ou um código de erro apropriado. STATUS_DEVICE_NOT_READY é o código de erro usual que indica que o quadro não pôde ser bloqueado. Esse código de erro frequentemente significa que o quadro para o qual o StreamPointer apontava foi cancelado.
Comentários
Um ponteiro de fluxo bloqueado garante que haja um quadro de dados associado ao ponteiro de fluxo e que esse quadro não seja cancelado desde que o bloqueio seja mantido. O minidriver deve bloquear um ponteiro de fluxo antes de tentar acessar os dados aos quais o ponteiro de fluxo aponta.
Se o pino referenciado pelo ponteiro de fluxo especificar que mapeamentos de dispersão/coleta de DMA devem ser gerados usando KSPIN_FLAG_GENERATE_MAPPINGS, o AVStream gerará os mapeamentos quando o ponteiro de fluxo estiver bloqueado.
Consulte também Stream Ponteiros.
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 |