Compartilhar via


PINT10_ALLOCATE_BUFFER função de retorno de chamada (video.h)

A função Int10AllocateBuffer pode ser usada para alocar um único bloco de memória de 4 KB no contexto de outro thread. Depois que o bloco de memória tiver sido alocado, ele deverá ser liberado antes que outro bloco de memória possa ser alocado.

Sintaxe

PINT10_ALLOCATE_BUFFER Pint10AllocateBuffer;

VP_STATUS Pint10AllocateBuffer(
  [in]      IN PVOID Context,
  [out]     OUT PUSHORT Seg,
  [out]     OUT PUSHORT Off,
  [in, out] IN OUT PULONG Length
)
{...}

Parâmetros

[in] Context

Ponteiro para um contexto definido pelo driver de porta de vídeo para a interface. Isso deve ser o mesmo que o valor no membro Context da estrutura VIDEO_PORT_INT10_INTERFACE após o retorno de VideoPortQueryServices .

[out] Seg

Ponteiro para um local de memória que receberá o endereço do segmento do buffer de memória alocado.

[out] Off

Ponteiro para um local de memória que receberá o deslocamento dentro do segmento especificado por *Seg, do buffer de memória alocado.

[in, out] Length

Ponteiro para um local de memória que contém o comprimento, em bytes, do buffer de memória solicitado, que pode ser tão grande quanto 4096. Quando a função retornar, esse local de memória conterá o valor 4096, se a memória foi realmente alocada.

Retornar valor

A função Int10AllocateBuffer retorna NO_ERROR após o sucesso. Ele retornará STATUS_INSUFFICIENT_RESOURCES se o buffer tiver sido alocado anteriormente ou se um tamanho de buffer maior que 4096 bytes for solicitado.

Comentários

A porta de vídeo implementa essa função, que pode ser acessada por meio de um ponteiro na estrutura VIDEO_PORT_INT10_INTERFACE .

Requisitos

Requisito Valor
Cliente mínimo com suporte Disponível no Windows 2000 e versões posteriores dos sistemas operacionais Windows.
Plataforma de Destino Área de Trabalho
Cabeçalho video.h (incluir Video.h)
IRQL PASSIVE_LEVEL

Confira também

VIDEO_PORT_INT10_INTERFACE