DXGKDDI_CREATEOVERLAY funzione di callback (d3dkmddi.h)
La funzione DxgkDdiCreateOverlay abilita l'hardware di sovrimpressione se l'hardware è in grado di supportare.
Sintassi
DXGKDDI_CREATEOVERLAY DxgkddiCreateoverlay;
NTSTATUS DxgkddiCreateoverlay(
[in] IN_CONST_HANDLE hAdapter,
[in/out] INOUT_PDXGKARG_CREATEOVERLAY pCreateOverlay
)
{...}
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/out] pCreateOverlay
Puntatore a una struttura DXGKARG_CREATEOVERLAY che descrive la sovrimpressione.
Valore restituito
DxgkDdiCreateOverlay restituisce uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
| STATUS_SUCCESS | DxgkDdiCreateOverlay ha creato correttamente la sovrimpressione. |
| STATUS_INVALID_PARAMETER | I parametri passati a DxgkDdiCreateOverlay contengono errori che impedivano il completamento. |
| STATUS_NO_MEMORY | DxgkDdiCreateOverlay non è riuscito ad allocare memoria necessaria per il completamento. |
| STATUS_INSUFFICIENT_RESOURCES | DxgkDdiCreateOverlay non è stato possibile completare perché la larghezza di banda insufficiente era disponibile o l'hardware di sovrimpressione richiesto non è riuscito a completare l'attività. |
| STATUS_GRAPHICS_DRIVER_MISMATCH | Il driver del miniport di visualizzazione non è compatibile con il driver di visualizzazione in modalità utente che ha avviato la chiamata a DxgkDdiCreateOverlay. |
Osservazioni
DxgkDdiCreateOverlay deve essere reso pageable.
Fabbisogno
| Requisito | Valore |
|---|---|
| client minimo supportato | Windows Vista |
| piattaforma di destinazione | Desktop |
| intestazione | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |