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

Confira também

KsStreamPointerUnlock