Partilhar via


Função KsCreateAllocator (ks.h)

A função KsCreateAllocator cria um identificador para um alocador para o identificador de conexão do coletor fornecido. Essa função não conclui o IRP ou define o status no IRP.

Sintaxe

KSDDKAPI NTSTATUS KsCreateAllocator(
  [in]  HANDLE               ConnectionHandle,
  [in]  PKSALLOCATOR_FRAMING AllocatorFraming,
  [out] PHANDLE              AllocatorHandle
);

Parâmetros

[in] ConnectionHandle

Especifica o identificador para a conexão do coletor na qual criar o alocador.

[in] AllocatorFraming

Enquadramento especificado para o alocador.

[out] AllocatorHandle

Especifica o ponteiro para um identificador para armazenar o identificador do alocador.

Valor de retorno

A função KsCreateAllocator retorna STATUS_SUCCESS se bem-sucedida ou retorna um erro se não tiver êxito.

Observações

Há duas versões da função KsCreateAllocator: uma para clientes de modo de usuário e outra para clientes no modo kernel. Essa função só pode ser chamada em PASSIVE_LEVEL para clientes no modo kernel.

Requisitos

Requisito Valor
da Plataforma de Destino Universal
cabeçalho ks.h (incluir Ks.h)
biblioteca Ks.lib
IRQL PASSIVE_LEVEL (seção Ver Comentários)

Consulte também

KSALLOCATOR_FRAMING