DXGKDDI_SUBMITCOMMAND funzione di callback (d3dkmddi.h)
La funzione dxgkDdiSubmitCommand invia un buffer DMA (Direct Memory Access) all'unità di esecuzione del comando hardware.
Sintassi
DXGKDDI_SUBMITCOMMAND DxgkddiSubmitcommand;
NTSTATUS DxgkddiSubmitcommand(
[in] IN_CONST_HANDLE hAdapter,
[in] IN_CONST_PDXGKARG_SUBMITCOMMAND pSubmitCommand
)
{...}
Parametri
[in] hAdapter
Handle di un blocco di contesto associato a una scheda di visualizzazione. Il driver miniport di visualizzazione precedentemente fornito questo handle al sottosistema kernel della grafica Microsoft DirectX nel MiniportDeviceContext parametro di output della funzione DxgkDdiAddDevice.
[in] pSubmitCommand
Puntatore a una struttura DXGKARG_SUBMITCOMMAND che descrive il buffer DMA inviato dal driver miniport visualizzato all'unità di esecuzione del comando hardware.
Valore restituito
DxgkDdiSubmitCommand restituisce STATUS_SUCCESS al completamento corretto. Se il driver restituisce invece un codice di errore, il sistema operativo causa un controllo errori del sistema. Vedere la sezione Osservazioni.
Osservazioni
Poiché le operazioni di paging sono considerate operazioni di sistema, non sono associate a un contesto di applicazione o a un contesto grafico specifico. Pertanto, quando l'invio è per un'operazione di paging, la funzione DxgkDdiSubmitCommand viene chiamata con NULL specificato nella hDevice membro della struttura DXGKARG_SUBMITCOMMAND a cui punta il parametro pSubmitCommand.
Tuttavia, se l'architettura di un determinato hardware e driver deve avere un dispositivo internamente, il driver deve creare internamente il dispositivo durante l'inizializzazione della scheda e deve mantenere il dispositivo internamente come dispositivo predefinito del sistema per l'uso nelle operazioni di paging.
Il driver può scrivere il valore fornito nel SubmissionFenceId membro di DXGKARG_SUBMITCOMMAND nel comando di recinto nel buffer circolare. Per altre informazioni sui comandi di isolamento, vedere Specifica di identificatori di isolamento.
Se il driver restituisce un codice di errore, il sottosistema kernel della grafica DirectX causa la verifica di un bug di sistema. In un file di dump di arresto anomalo del sistema, l'errore viene indicato dal messaggio BugCheck 0x119, che avrà i quattro parametri seguenti.
- 0x2 (identifica la causa dell'errore)
- Codice di errore NTSTATUS restituito dalla chiamata al driver non riuscito
- Puntatore alla struttura DXGKARG_SUBMITCOMMAND
- Puntatore a una struttura di dati dell'utilità di pianificazione interna
dxgkDdiSubmitCommand deve essere reso non modificabile perché viene eseguito in IRQL = DISPATCH_LEVEL.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| piattaforma di destinazione | Desktop |
| intestazione | d3dkmddi.h |
| IRQL | DISPATCH_LEVEL |