Função VideoPortAllocateBuffer (video.h)

A função VideoPortAllocateBuffer é obsoleta no Windows 2000 e posterior. Em seu lugar, os drivers de miniporto de vídeo devem, em vez disso, usar VideoPortAllocatePool .

VideoPortAllocateBuffer aloca um buffer de memória de pool de páginas.

Sintaxe

VIDEOPORT_DEPRECATED VIDEOPORT_API VP_STATUS VideoPortAllocateBuffer(
  [in]  IN PVOID  HwDeviceExtension,
  [in]  IN ULONG  Size,
  [out] OUT PVOID *Buffer
);

Parâmetros

[in] HwDeviceExtension

Ponteiro para a extensão do dispositivo do driver de miniport.

[in] Size

Especifica o tamanho do buffer a ser alocado, em bytes.

[out] Buffer

É o local em que o driver da porta de vídeo retorna um ponteiro para um ponteiro para a memória do pool alocada.

Valor de retorno

VideoPortAllocateBuffer retorna NO_ERROR quando conclui com êxito a solicitação de alocação ou ERROR_NOT_ENOUGH_MEMORY se não for possível alocar um buffer de Tamanho bytes. Um valor retornado de ERROR_INSUFFICIENT_BUFFER indica que um driver de miniporto excedeu sua alocação máxima permitida de memória.

Observações

Um driver de miniporto pode usar o valor retornado dessa função para determinar se a alocação do buffer foi bem-sucedida.

Requisitos

Requisito	Valor
de cliente com suporte mínimo	Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows.
da Plataforma de Destino	Área de trabalho
cabeçalho	video.h (inclua Video.h)
biblioteca	Videoprt.lib
de DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL

Consulte também

VideoPortReleaseBuffer