Funzione VideoPortAllocateCommonBuffer (video.h)

La funzione VideoPortAllocateCommonBuffer alloca e mappa la memoria di sistema in modo che sia accessibile simultaneamente sia dal processore che da un dispositivo per le operazioni DMA del buffer comuni.

Sintassi

VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortAllocateCommonBuffer(
  [in]  IN PVOID              HwDeviceExtension,
  [in]  IN PVP_DMA_ADAPTER    VpDmaAdapter,
  [in]  IN ULONG              DesiredLength,
  [out] OUT PPHYSICAL_ADDRESS LogicalAddress,
  [in]  IN BOOLEAN            CacheEnabled,
  [out] OUT PVOID             Reserved
);

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo del driver miniport.

[in] VpDmaAdapter

Puntatore alla struttura VP_DMA_ADAPTER che rappresenta l'adattatore bus-master. Questa struttura è stata restituita da una chiamata precedente a VideoPortGetDmaAdapter.

[in] DesiredLength

Specifica il numero richiesto di byte di memoria.

[out] LogicalAddress

Puntatore a un percorso di memoria che riceve l'indirizzo logico da usare dall'adattatore per accedere al buffer allocato.

[in] CacheEnabled

Specifica se la memoria allocata può essere memorizzata nella cache. Per altre informazioni, vedere la descrizione del parametro CacheEnabled per AllocateCommonBuffer.

[out] Reserved

Attualmente viene ignorato dal driver della porta video; deve essere impostato su NULL.

Valore restituito

VideoPortAllocateCommonBuffer restituisce l'indirizzo virtuale di base del buffer allocato in caso di esito positivo; in caso contrario, restituisce NULL se il buffer non può essere allocato.

Commenti

Quando il buffer non è più necessario, il driver miniport video deve rilasciarlo chiamando VideoPortReleaseCommonBuffer.

Requisiti

Requisito	Valore
Client minimo supportato	Disponibile in Windows XP 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

AllocateCommonBuffer

VP_DMA_ADAPTER

VideoPortGetDmaAdapter

VideoPortReleaseCommonBuffer