Função ParserTemporaryLockFrame

A função ParserTemporaryLockFrame bloqueia um quadro quando entra em um analisador e desbloqueia o quadro quando a função sai do analisador.

Sintaxe

LPBYTE WINAPI ParserTemporaryLockFrame(
  _In_ HFRAME hFrame
);

Parâmetros

hFrame [in]

Manipule para o quadro para o qual o analisador aponta.

Valor retornado

Se a função for bem-sucedida, o valor retornado será um ponteiro para o primeiro byte de dados no quadro.

Se a função não for bem-sucedida, o valor retornado será NULL.

Comentários

Os analisadores não devem chamar a função LockFrame . Se um analisador usa um bloqueio e, em seguida, gera uma falha ou retorna sem desbloquear o quadro, o analisador deixa o sistema em um estado em que ele não pode alterar protocolos ou recortar ou copiar quadros. Os analisadores devem usar a função ParserTemporaryLockFrame , que concede um bloqueio somente durante o contexto da entrada da função no analisador. Ao sair do analisador, o bloqueio desse quadro é liberado. Como resultado, o ponteiro será válido somente depois que o analisador retornar da chamada para a função AttachProperties ou RecognizeFrame .

Requisitos