Funzione DriverEntry di un driver miniport di visualizzazione
La funzione DriverEntry fornisce il sottosistema kernel grafico DirectX (Dxgkrnl) con un set di puntatori alle funzioni implementate dal driver miniport (KMD) di visualizzazione.
Sintassi
NTSTATUS DriverEntry(
_In_ PDRIVER_OBJECT DriverObject,
_In_ PUNICODE_STRING RegistryPath
);
Parametri
DriverObject è un puntatore a una struttura DRIVER_OBJECT che rappresenta il driver formato dalla coppia di driver (porta di visualizzazione, porta di visualizzazione).
RegistryPath è un puntatore a una struttura UNICODE_STRING che fornisce il percorso alla chiave del Registro di sistema del driver.
Valore restituito
DriverEntry deve restituire il valore restituito dalla chiamata a DxgkInitialize.
Osservazioni:
DriverEntry deve eseguire i passaggi seguenti:
Allocare una struttura DRIVER_INITIALIZATION_DATA e impostarne il membro Version su DXGKDDI_INTERFACE_VERSION, definito in Dispmprt.h.
Compilare i membri rimanenti di DRIVER_INITIALIZATION_DATA con puntatori alle funzioni implementate dal KmD.
Passare DriverObject, RegistryPath e la struttura compilata DRIVER_INITIALIZATION_DATA a DxgkInitialize.
Restituisce il valore restituito da DxgkInitialize.
La struttura DRIVER_INITIALIZATION_DATA non deve rimanere in memoria dopo la restituzione di DriverEntry .
DriverEntry deve essere reso pageable.
DriverEntry per un driver di sola visualizzazione in modalità kernel
Per l'interfaccia del driver di sola visualizzazione (KMDOD) in modalità kernel, la struttura KMDDOD_INITIALIZATION_DATA elenca tutte le funzioni che possono essere implementate da un KMDOD. Tutte queste funzioni, ad eccezione della funzione DxgkDdiPresentDisplayOnly , possono essere implementate anche da un driver miniport a schermo completo (KMD). La funzione DriverEntry del KMDOD fornisce puntatori a funzione al driver della porta di visualizzazione compilando tutti i membri di KMDDOD_INITIALIZATION_DATA e quindi passando tale struttura alla funzione DxgkInitializeDisplayOnlyDriver.
Se un KMDOD non supporta la funzionalità di controllo VSync, non deve implementare determinate funzioni. Vedere Risparmio energetico con il controllo VSync.
Le strutture e l'enumerazione seguenti vengono usate anche con KMDOD:
- D3DKMT_MOVE_RECT
- D3DKMT_PRE edizione Standard NT_DISPLAY_ONLY_FLAGS
- DXGK_PRE edizione Standard NT_DISPLAY_ONLY_PROGRESS_ID
- DXGKARG_PRE edizione Standard NT_DISPLAYONLY
- DXGKARGCB_PRE edizione Standard NT_DISPLAYONLY_PROGRESS
Requisiti
| Requisito | Dettagli |
|---|---|
| Piattaforma di destinazione | Desktop |
| Client minimo supportato | Windows Vista |
| Libreria | NtosKrnl.lib |
| DLL | NtosKrnl.exe |