Compartilhar 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 nem 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.

Retornar valor

A função KsCreateAllocator retornará STATUS_SUCCESS se tiver êxito ou retornará um erro se não tiver êxito.

Comentários

Há duas versões da função KsCreateAllocator : uma para clientes do 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
Plataforma de Destino Universal
Cabeçalho ks.h (inclua Ks.h)
Biblioteca Ks.lib
IRQL PASSIVE_LEVEL (consulte a seção Comentários)

Confira também

KSALLOCATOR_FRAMING