Função VideoPortLockPages (video.h)

Artigo
02/07/2025

A função VideoPortLockPages é obsoleta no Windows 2000 e posterior. Use VideoPortLockBuffer no lugar dessa função.

VideoPortLockPages bloqueia a memória virtual especificada e possivelmente executa parte ou toda uma transferência de DMA.

Sintaxe

VIDEOPORT_DEPRECATED VIDEOPORT_API BOOLEAN VideoPortLockPages(
  [in]      IN PVOID                     HwDeviceExtension,
  [in, out] IN OUT PVIDEO_REQUEST_PACKET pVrp,
  [in]      IN PEVENT                    pUEvent,
  [in]      IN PEVENT                    pDisplayEvent,
  [in]      IN DMA_FLAGS                 DmaFlags
);

Parâmetros

[in] HwDeviceExtension

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

[in, out] pVrp

Ponteiro para uma estrutura VIDEO_REQUEST_PACKET. O driver de miniporto deve ter definido InputBuffer e InputBufferLength para conter o endereço virtual e o tamanho em bytes, respectivamente, da memória a ser bloqueada para a transferência. Essa memória foi alocada pelo driver de exibição e passada para o driver de miniporto por meio de um IOCTL. A porta de vídeo retorna um ponteiro e o tamanho em bytes da lista de dispersão/coleta em OutputBuffer e OutputBufferLength, respectivamente.

[in] pUEvent

Ponteiro para um evento de usuário mapeado que deve ser definido pelo driver de miniporto ou NULL. O evento do usuário foi mapeado pelo driver de exibição e passado para o driver de miniporto por meio de um IOCTL.

[in] pDisplayEvent

Ponteiro para um evento que deve ser definido pelo driver de miniporto ou NULL. Esse evento foi criado e recebido do driver de exibição por meio de um IOCTL.

[in] DmaFlags

Especifica a ação a ser executada. Esse parâmetro deve ser um dos seguintes valores:

Valor	Significado
VideoPortDmaInitOnly	O VideoPortLockPages bloqueia a memória solicitada.
VideoPortKeepPagesLocked	VideoPortLockPages não toma nenhuma ação.
VideoPortUnlockAfterDma	VideoPortLockPages não toma nenhuma ação.

Valor de retorno

VideoPortLockPages retorna verdadeiro após a conclusão bem-sucedida da ação solicitada. Ele retornará FALSE se o parâmetro DmaFlags não for igual a VideoPortDmaInitOnly.

Observações

Consulte Bus-Master DMA em Drivers de Miniporto de Vídeo para obter informações sobre transferências de DMA baseadas em pacotes e de buffer comum.

VideoPortLockPages não pode ser chamado de um ISR ou DPC.

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

Consulte também

VideoPortLockBuffer

Partilhar via