Método IAllocatorMXF::GetBuffer (dmusicks.h)

O GetBuffer método aloca um buffer para eventos MIDI longos.

Sintaxe

NTSTATUS GetBuffer(
  [out] PBYTE *ppBuffer
);

Parâmetros

[out] ppBuffer

Ponteiro de saída para o buffer. Esse parâmetro aponta para uma variável de ponteiro alocada pelo chamador na qual o método grava um ponteiro no buffer.

Retornar valor

GetBuffer retornará S_OK se a chamada tiver sido bem-sucedida. Caso contrário, o método retorna um código de erro apropriado.

Comentários

O driver de miniporto chama esse método somente quando precisa enviar grandes partes de dados para o coletor de captura. Especificamente, o driver de miniporto usa esse método sempre que um componente precisa empacotar mais dados do que pode ser armazenado no membro uData do DMUS_KERNEL_EVENT.

O tamanho do buffer pode ser determinado chamando IAllocatorMXF::GetBufferSize. GetBufferSize precisa ser chamado apenas uma vez porque o tamanho do buffer é constante para qualquer implementação do alocador.

Requisitos

Confira também

DMUS_KERNEL_EVENT

IAllocatorMXF

IAllocatorMXF::GetBufferSize