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 fornito in precedenza questo handle al sottosistema kernel della grafica Microsoft DirectX nel parametro di output MiniportDeviceContext della funzione DxgkDdiAddDevice .
[in] pSubmitCommand
Puntatore a una struttura DXGKARG_SUBMITCOMMAND che descrive il buffer DMA inviato dal driver miniport di visualizzazione all'unità di esecuzione del comando hardware.
Valore restituito
DxgkDdiSubmitCommand restituisceSTATUS_SUCCESS al completamento. Se il driver restituisce invece un codice di errore, il sistema operativo causa un controllo di bug del sistema. Vedere la sezione Osservazioni.
Commenti
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 nel membro hDevice 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 membro SubmissionFenceId di DXGKARG_SUBMITCOMMAND nel comando di isolamento 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 grafico DirectX causa un controllo di bug del 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.
Requisiti
| Requisito | Valore |
|---|---|
| Client minimo supportato | Windows Vista |
| Piattaforma di destinazione | Desktop |
| Intestazione | d3dkmddi.h |
| IRQL | DISPATCH_LEVEL |