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.
Valor de retorno
KsStreamPointerLock retorna STATUS_SUCCESS, indicando que o ponteiro do 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 StreamPointer estava apontando foi cancelado.
Observações
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 que o ponteiro de fluxo faz referência 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 de Ponteiros de Fluxo.
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 |