DXGKDDI_DISCONNECTDOORBELL función de devolución de llamada (d3dkmddi.h)
Importante
Cierta información se relaciona con un producto de versión preliminar que puede modificarse sustancialmente antes de su publicación comercial. Microsoft no ofrece ninguna garantía, expresa o implícita, con respecto a la información proporcionada aquí.
La función DxgkDdiDisconnectDoorbell desconecta un timbre conectado previamente de una cola de hardware.
Sintaxis
DXGKDDI_DISCONNECTDOORBELL DxgkddiDisconnectdoorbell;
NTSTATUS DxgkddiDisconnectdoorbell(
INOUT_PDXGKARG_DISCONNECTDOORBELL pArgs
)
{...}
Parámetros
pArgs
[in/out] Puntero a una estructura de DXGKARG_DISCONNECTDOORBELL que describe el timbre para desconectar.
Valor devuelto
dxgkDdiDisconnectDoorbell deben realizarse correctamente y devolver STATUS_SUCCESS.
Observaciones
El sistema operativo llama a DxgkDdiDisconnectDoorbell para desasignar la ubicación del timbre físico asignada a este timbre. KMD debe desconectar la cola de hardware, la dirección física del timbre de puerta y el motor, etc. La ubicación del timbre físico se puede asignar a algún otro objeto de timbre lógico.
KMD no debe destruir ni liberar ningún otro objeto asociado a hDoorbell porque el objeto doorbell no se está destruyendo y se puede volver a conectar en un momento posterior.
Al volver desde esta llamada DDI, Dxgkrnl realiza los pasos siguientes para desconectar el timbre de la puerta:
- Gira el modo de usuario DoorbellCpuVirtualAddress a una página ficticia para que UMD ya no pueda escribir en la ubicación física del timbre.
- Escribe D3DDDI_DOORBELL_STATUS_DISCONNECTED_RETRY en DoorbellStatusCpuVirtualAddress para que UMD sepa que el timbre está desconectado.
Para obtener más información, consulte envío de trabajo en modo de usuario.
Requisitos
| Requisito | Valor |
|---|---|
| cliente mínimo admitido | Windows 11, versión 24H2 (WDDM 3.2) |
| encabezado de | d3dkmddi.h |
| irQL | PASSIVE_LEVEL |