Função de retorno de chamada PFNKSSTREAMPOINTER (ks.h)
O AVStream chama a rotina de AVStrMiniCancelCallback de um minidriver quando o IRP associado a um ponteiro de fluxo clonado é cancelado. Essa rotina é opcional.
Sintaxe
PFNKSSTREAMPOINTER Pfnksstreampointer;
void Pfnksstreampointer(
[in] PKSSTREAM_POINTER StreamPointer
)
{...}
Parâmetros
[in] StreamPointer
Um ponteiro para o clone KSSTREAM_POINTER associado ao IRP que foi cancelado. do StreamPointer foi criado por uma chamada para KsStreamPointerClone.
Valor de retorno
Nenhum
Observações
O minidriver especifica o endereço dessa rotina no parâmetro CancelCallback de KsStreamPointerClone.
Em AVStrMiniCancelCallback, o minidriver deve definir todas as referências ao ponteiro de clone para NULL.
Além disso, o minidriver deve remover todas as informações de contexto relacionadas ao ponteiro de clone e notificar o hardware sobre o cancelamento.
Por fim, o minidriver deve chamar KsStreamPointerDelete para excluir o clone e o contexto associado a ele. Se o minidriver não excluir o clone, o IRP manterá uma contagem de referência e não será concluída, possivelmente fazendo com que os aplicativos relacionados falhem.
AVStrMiniCancelCallback é chamado com o bloqueio de rotação da fila mantido, portanto, em DISPATCH_LEVEL. Assim, a rotina de retorno de chamada não pode executar a manipulação de fila ou as funções de chamada que adquirem um mutex.
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 | Área de trabalho |
| cabeçalho | ks.h (incluir Ks.h) |