DXGKDDI_PROTECTED_CALLBACK función de devolución de llamada (dispmprt.h)
La rutina de devolución de llamada DxgkProtectedCallback se implementa mediante el controlador de miniporte de pantalla y es llamada por DxgkCbExcludeAdapterAccess durante un estado protegido cuando se impide todo el acceso al adaptador de pantalla.
Sintaxis
DXGKDDI_PROTECTED_CALLBACK DxgkddiProtectedCallback;
void DxgkddiProtectedCallback(
[in] IN_CONST_PVOID MiniportDeviceContext,
[in] PVOID ProtectedCallbackContext,
[in] NTSTATUS ProtectionStatus
)
{...}
Parámetros
[in] MiniportDeviceContext
Identificador de un bloque de contexto asociado a un adaptador de pantalla. La función DxgkDdiAddDevice del controlador de minipuerto de pantalla proporcionó anteriormente este identificador al subsistema del kernel de gráficos de DirectX.
[in] ProtectedCallbackContext
Puntero a la información definida por el controlador que se especificó en una llamada anterior a DxgkCbExcludeAdapterAccess.
[in] ProtectionStatus
Estado del estado protegido del adaptador de pantalla. Si STATUS_SUCCESS, el adaptador se protegió correctamente del acceso. Un código de estado de error indica que el adaptador no está protegido.
Valor devuelto
None
Observaciones
Se debe llamar a DxgkProtectedCallback solo cuando se ha detenido todo el acceso al adaptador de pantalla, como se indica en el parámetro status ProtectionStatus.
El controlador debe asegurarse de que se cumplen las siguientes condiciones durante la rutina de devolución de llamada:
- Todas las interrupciones del dispositivo están deshabilitadas y las interrupciones pendientes restantes se controlan, incluidos los DPC que se pueden haber puesto en cola en cualquier CPU, pero que aún no están en servicio.
- Se han vaciado toda la memoria combinada de escritura y cualquier otro estado relacionado con la memoria caché.
- Los eventos ACPI o BIOS/SMI que se producen no tienen acceso al hardware.
- La coherencia se logra entre todos los adaptadores en una configuración de estado de adaptador vinculado.
- El adaptador, incluidos sus registros y modo de presentación, se mantiene en el estado adecuado para controlar el búfer DMA que se produce en el retorno de la rutina DxgkProtectedCallback . El controlador no debe cambiar el estado visible ni las funcionalidades de ninguna aplicación.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Plataforma de destino | Escritorio |
| Encabezado | dispmprt.h (incluir Dispmprt.h) |
| IRQL | PASSIVE_LEVEL |