DXGKCB_PINFRAMEBUFFERFORSAVE2 funzione di callback (d3dkmddi.h)

  • Articolo

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

DXGKARGCB_PINFRAMEBUFFERFORSAVE

DXGKCB_UNPINFRAMEBUFFERFORSAVE