Compartilhar via

Função VideoPortLockPages (video.h)

  • Artigo

A função VideoPortLockPages está 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 de dispositivo do driver de miniport.

[in, out] pVrp

Ponteiro para uma estrutura VIDEO_REQUEST_PACKET . O driver de miniporte 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 para 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 por 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 VideoPortLockPages bloqueia a memória solicitada.
VideoPortKeepPagesLocked VideoPortLockPages não executa nenhuma ação.
VideoPortUnlockAfterDma VideoPortLockPages não executa nenhuma ação.

Retornar valor

VideoPortLockPages retorna TRUE 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.

Comentários

Consulte DMA do Bus-Master 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
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 (inclua Video.h)
Biblioteca Videoprt.lib
DLL Videoprt.sys

Confira também

VideoPortLockBuffer