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 dal processore e da un dispositivo per le operazioni DMA del buffer comune.

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 ignora attualmente 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 in caso di esito positivo; in caso contrario, restituisce NULL se il buffer non può essere allocato.

Commenti

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

Requisiti

Vedi anche

VideoPortAllocateCommonBuffer