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 KSPIN que descreve o pino ao qual o alocador deve ser associado.

[in] AllocatorFraming

Ponteiro para uma estrutura 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 por 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 allocatorFraming para Pin e Context é o único parâmetro que o AVStream passará.)

Retornar valor

AVStrMiniInitializeAllocator deve retornar STATUS_SUCCESS ou o código de erro que recebeu tentando criar o alocador.

Comentários

O minidriver especifica o endereço dessa rotina no membro InitializeAllocator de sua estrutura KSALLOCATOR_DISPATCH . O minidriver passa essa estrutura para o driver de classe em KSPIN_DISPATCH.

Observe que os alocadores do 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 alocação de memória e solicitações gratuitas.

Para obter mais informações, consulte Alocadores de KS.

Requisitos

Confira também

AVStrMiniDeleteAllocator

KSALLOCATOR_DISPATCH

KSALLOCATOR_FRAMING

KSPIN

KSPIN_DISPATCH