Funzione VideoPortAllocateContiguousMemory (video.h)

Articolo
08/07/2023

La funzione VideoPortAllocateContiguousMemory è obsoleta in Windows 2000 e versioni successive. I driver miniport video devono usare VideoPortAllocateCommonBuffer al suo posto.

VideoPortAllocateContiguousMemory alloca una gamma di memoria fisicamente contigua e allineata alla cache dal pool non di paging.

Sintassi

VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortAllocateContiguousMemory(
  [in] IN PVOID            HwDeviceExtension,
  [in] IN ULONG            NumberOfBytes,
  [in] IN PHYSICAL_ADDRESS HighestAcceptableAddress
);

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo del driver miniport.

[in] NumberOfBytes

Specifica le dimensioni in byte del blocco di memoria contigua da allocare.

[in] HighestAcceptableAddress

Specifica l'indirizzo fisico più alto che il driver miniport può usare. Ad esempio, se un dispositivo può fare riferimento solo alla memoria fisica nella parte inferiore di 16 MB, questo valore verrà impostato su 0x00000000FFFFFF.

Valore restituito

VideoPortAllocateContiguousMemory restituisce l'indirizzo virtuale di base per la memoria allocata, se la chiamata ha esito positivo. Se la richiesta non può essere soddisfatta, viene restituito NULL .

Commenti

VideoPortAllocateContiguousMemory può essere chiamato per allocare un blocco contiguo di memoria fisica per un buffer interno a lungo termine.

Un driver miniport che deve usare memoria contigua deve allocare solo le risorse necessarie durante l'inizializzazione del driver perché è probabile che il pool non in pagine diventi frammentato durante l'esecuzione del sistema. Se il driver miniport viene scaricato, deve deallocare la memoria. Le allocazioni contigue sono allineate su un multiplo integrale delle dimensioni della riga di cache dei dati del processore per evitare problemi di cache e coerenza.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows.
Piattaforma di destinazione	Desktop
Intestazione	video.h (include Video.h)
Libreria	Videoprt.lib
DLL	Videoprt.sys
IRQL	PASSIVE_LEVEL

Vedi anche

VideoPortAllocateBuffer

Condividi tramite