Funzione VideoPortAllocateCommonBuffer (video.h)
La funzione videoPortAllocateCommonBuffer 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 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 una posizione 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 se ha esito positivo; in caso contrario, restituisce NULL se non è possibile allocare il buffer.
Osservazioni
Quando il buffer non è più necessario, il driver miniport video deve rilasciarlo chiamando VideoPortReleaseCommonBuffer.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Disponibile in Windows XP 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 |