Função VideoPortAllocateContiguousMemory (video.h)
A função VideoPortAllocateContiguousMemory está obsoleta no Windows 2000 e posterior. Os drivers de miniporto de vídeo devem usar VideoPortAllocateCommonBuffer em seu lugar.
VideoPortAllocateContiguousMemory aloca um intervalo de memória fisicamente contígua e alinhada a cache do pool nãopagado.
Sintaxe
VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortAllocateContiguousMemory(
[in] IN PVOID HwDeviceExtension,
[in] IN ULONG NumberOfBytes,
[in] IN PHYSICAL_ADDRESS HighestAcceptableAddress
);
Parâmetros
[in] HwDeviceExtension
Ponteiro para a extensão de dispositivo do driver de miniport.
[in] NumberOfBytes
Especifica o tamanho em bytes do bloco de memória contígua a ser alocado.
[in] HighestAcceptableAddress
Especifica o endereço físico mais alto válido que o driver de miniporto pode usar. Por exemplo, se um dispositivo só puder fazer referência à memória física nos 16 MB inferiores, esse valor será definido como 0x00000000FFFFFF.
Retornar valor
VideoPortAllocateContiguousMemory retorna o endereço virtual base para a memória alocada, se a chamada for bem-sucedida. Se a solicitação não puder ser atendida, NULL será retornado.
Comentários
VideoPortAllocateContiguousMemory pode ser chamado para alocar um bloco contíguo de memória física para um buffer interno de longo prazo.
Um driver de miniporto que deve usar memória contígua deve alocar apenas o que precisa durante a inicialização do driver porque o pool nãopagado provavelmente ficará fragmentado à medida que o sistema é executado. Se o driver de miniporto for descarregado, ele deverá desalocar a memória. Alocações contíguas são alinhadas em um múltiplo integral do tamanho da linha de cache de dados do processador para evitar problemas de cache e coerência.
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 |
| IRQL | PASSIVE_LEVEL |