Funzione VideoPortGetCommonBuffer (video.h)

La funzione VideoPortGetCommonBuffer è obsoleta in Windows XP e versioni successive ed è supportata solo per la compatibilità con le versioni precedenti con i driver esistenti. Al suo posto, i writer di driver devono usare VideoPortAllocateCommonBuffer.

VideoPortGetCommonBuffer alloca e esegue il mapping della memoria di sistema in modo che sia accessibile simultaneamente sia dal processore che da un dispositivo per le operazioni DMA comuni del buffer.

Sintassi

VIDEOPORT_DEPRECATED VIDEOPORT_API PVOID VideoPortGetCommonBuffer(
  [in]  IN PVOID              HwDeviceExtension,
  [in]  IN ULONG              DesiredLength,
  [in]  IN ULONG              Alignment,
  [out] OUT PPHYSICAL_ADDRESS LogicalAddress,
  [out] OUT PULONG            pActualLength,
  [in]  IN BOOLEAN            CacheEnabled
);

Parametri

[in] HwDeviceExtension

Puntatore all'estensione del dispositivo del driver miniport.

[in] DesiredLength

Specifica il numero richiesto di byte di memoria.

[in] Alignment

Specifica l'allineamento richiesto del buffer. Il driver della porta video attualmente ignora questo parametro.

[out] LogicalAddress

Puntatore a una variabile che riceve l'indirizzo logico da usare dall'adattatore per accedere al buffer allocato.

[out] pActualLength

Puntatore a una variabile che riceve le dimensioni effettive, in byte, del buffer allocato per questa richiesta.

[in] CacheEnabled

Specifica se la memoria allocata può essere memorizzata nella cache.

Valore restituito

VideoPortGetCommonBuffer restituisce l'indirizzo virtuale di base del buffer allocato se ha esito positivo; in caso contrario, restituisce NULL se non è possibile allocare il buffer.

Osservazioni

Vedere Bus-Master DMA in Video Miniport Drivers per informazioni sui trasferimenti DMA di buffer comuni e basati su pacchetti.

Fabbisogno

Requisito	Valore
client minimo supportato	Disponibile in Windows 2000 e versioni successive dei sistemi operativi Windows.
piattaforma di destinazione	Desktop
intestazione	video.h (includere Video.h)
libreria	Videoprt.lib
dll	Videoprt.sys
IRQL	PASSIVE_LEVEL

Vedere anche

VideoPortAllocateCommonBuffer