DXGKDDI_BUILDTESTCOMMANDBUFFER funzione di callback (d3dkmddi.h)
La funzione di DXGKDDI_BUILDTESTCOMMANDBUFFER kmD compila un buffer dei comandi di test per test in modalità kernel.
Sintassi
DXGKDDI_BUILDTESTCOMMANDBUFFER DxgkddiBuildtestcommandbuffer;
NTSTATUS DxgkddiBuildtestcommandbuffer(
IN_CONST_HANDLE hAdapter,
INOUT_PDXGKARG_BUILDTESTCOMMANDBUFFER pArgs
)
{...}
Parametri
hAdapter
[in] Handle di un blocco di contesto associato a una scheda di visualizzazione. Il driver miniport in modalità kernel (KMD) precedentemente fornito questo handle per dxgkrnl nel MiniportDeviceContext parametro di output della funzione DxgkDdiAddDevice.
pArgs
[in/out] Puntatore a una struttura DXGKARG_BUILDTESTCOMMANDBUFFER che descrive il buffer dei comandi di test da compilare.
Valore restituito
DXGKDDI_BUILDTESTCOMMANDBUFFER restituisce NTSTATUS_SUCCESS se la funzione ha esito positivo. In caso contrario, restituisce un codice NTSTATUS appropriato, ad esempio STATUS_BUFFER_OVERFLOW.
Osservazioni
DXGKDDI_BUILDTESTCOMMANDBUFFER compila un buffer dei comandi con istruzioni specifiche del dispositivo per un set di comandi semplici. KMD restituisce un puntatore a questa funzione in pfnBuildTestCommandBuffer tramite DxgkDdiQueryFeatureInterface(DXGK_FEATURE_KERNEL_MODE_TESTING).
Quando pDmaBuffer è NULL o è troppo piccolo, kmd deve impostare le dimensioni necessarie per il buffer in DmaBufferSize e restituire STATUS_BUFFER_OVERFLOW.
Quando pDmaBufferPrivateData è NULL o troppo piccolo e kmD deve generare dati privati, kmd deve impostare le dimensioni necessarie in DmaBufferPrivateDataSize e restituire STATUS_BUFFER_OVERFLOW.
Il KMD deve calcolare le dimensioni di entrambi i buffer nella stessa chiamata.
Per altre informazioni, vedere test in modalità kernel.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows 11, versione 24H2 (WDDM 3.2) |
| intestazione | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |