Compartilhar via


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)

Confira também

KSSTREAM_POINTER

KsStreamPointerClone

KsStreamPointerDelete