DXGKCB_PINFRAMEBUFFERFORSAVE2 funzione di callback (d3dkmddi.h)
Un driver miniport in modalità kernel chiama DXGKCB_PINFRAMEBUFFERFORSAVE2 per aggiungere un intero buffer dei fotogrammi contemporaneamente.
Sintassi
DXGKCB_PINFRAMEBUFFERFORSAVE2 DxgkcbPinframebufferforsave2;
NTSTATUS DxgkcbPinframebufferforsave2(
[in] IN_CONST_HANDLE hAdapter,
[in/out] INOUT_PDXGKARGCB_PINFRAMEBUFFERFORSAVE2 pPinFrameBufferForSave2
)
{...}
Parametri
[in] hAdapter
Handle per una scheda di visualizzazione. Il driver fornisce questo handle per il dispositivo main/lead nella catena dell'adattatore di visualizzazione collegato .The driver provides this handle for the main/lead device in the linked display adapter (LDA) chain.
[in/out] pPinFrameBufferForSave2
Puntatore a una struttura DXGKARGCB_PINFRAMEBUFFERFORSAVE2 che contiene informazioni sul buffer dei frame da salvare.
Valore restituito
DXGKCB_PINFRAMEBUFFERFORSAVE2 restituisce STATUS_SUCCESS se l'operazione ha esito positivo. In caso contrario, restituisce un codice di errore NTSTATUS appropriato.
Commenti
L'implementazione di IOMMU WDDM 2.4 originale includeva una coppia di funzioni di callback per eseguire query sulla memoria necessaria per salvare il buffer dei fotogrammi. L'area di salvataggio del buffer dei frame è stata creata come oggetto sezione durante l'inizializzazione e il driver ha usato questi callback per ottenere un'area mappata di IOMMU quando necessario.
I driver che usano elenchi di descrittori di indirizzi (ADLs) per supportare il mapping DMA logico implementano DXGKCB_PINFRAMEBUFFERFORSAVE2 anziché DXGKARGCB_PINFRAMEBUFFERFORSAVE.
La memoria aggiunta tramite DXGKCB_PINFRAMEBUFFERFORSAVE2 può essere rimossa usando il callback DXGKCB_UNPINFRAMEBUFFERFORSAVE originale.
Per altre informazioni, vedere Il mapping DMA di IOMMU .
DXGKCB_XXX funzioni vengono implementate da Dxgkrnl. Per usare questa funzione di callback, impostare i membri appropriati di DXGKARGCB_PINFRAMEBUFFERFORSAVE2 e quindi chiamare DxgkCbPinFrameBufferForSave2 tramite il DXGKRNL_INTERFACE.
Requisiti
| Requisito | Valore |
|---|---|
| Server minimo supportato | Windows Server 2022 (WDDM 2.9) |
| Intestazione | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |
Vedi anche
DXGKARGCB_PINFRAMEBUFFERFORSAVE2