Função de retorno de chamada PFNKSPININITIALIZEALLOCATOR (ks.h)
A rotina AVStrMiniInitializeAllocator de um minidriver AVStream inicializa um alocador que será associado a um pin.
Sintaxe
PFNKSPININITIALIZEALLOCATOR Pfnkspininitializeallocator;
NTSTATUS Pfnkspininitializeallocator(
[in] PKSPIN Pin,
[in] PKSALLOCATOR_FRAMING AllocatorFraming,
[out] PVOID *Context
)
{...}
Parâmetros
[in] Pin
Ponteiro para uma estrutura de KSPIN que descreve o pino ao qual o alocador deve ser associado.
[in] AllocatorFraming
Ponteiro para uma estrutura de KSALLOCATOR_FRAMING que descreve os requisitos de enquadramento que o alocador deve usar.
[out] Context
Ponteiro para um contexto para o alocador que será passado como um parâmetro para as outras rotinas dessa estrutura. Por exemplo, o driver pode armazenar estruturas de enquadramento de pino ou alocador para referência posterior pelas outras rotinas de retorno de chamada. Observe que outras rotinas para KSALLOCATOR_DISPATCH devem ter pelo menos uma maneira indireta de referenciar Pin. (Por exemplo, AVStrMiniAllocate precisará ser capaz de acessar as informações de AllocatorFraming para Pine Context é o único parâmetro que o AVStream passará.)
Valor de retorno
AVStrMiniInitializeAllocator deve retornar STATUS_SUCCESS ou o código de erro que recebeu tentando criar o alocador.
Observações
O minidriver especifica o endereço dessa rotina no membro InitializeAllocator membro de sua estrutura KSALLOCATOR_DISPATCH. O minidriver passa essa estrutura para o driver de classe em KSPIN_DISPATCH.
Observe que os alocadores no modo kernel não podem alocar quadros que possam eventualmente chegar ao modo de usuário.
O AVStream chama AVStrMiniInitializeAllocator para inicializar o alocador fornecido. O manipulador para essa rotina deve se preparar para lidar com a alocação de memória e solicitações gratuitas.
Para obter mais informações, consulte alocadores KS.
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) |