Função de retorno de chamada PFNKSSTREAMPOINTER (ks.h)
O AVStream chama a rotina 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. O StreamPointer foi criado por uma chamada para KsStreamPointerClone.
Retornar valor
Nenhum
Comentários
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 como 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 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 funções de manipulação de fila ou de chamada que adquirem um mutex.
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 | Área de Trabalho |
| Cabeçalho | ks.h (inclua Ks.h) |