DXGKDDI_CONNECTDOORBELL 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í.
DxgkDdiConnectDoorbell conecta (o vuelve a conectar) un objeto de timbre creado anteriormente a una cola de hardware.
Sintaxis
DXGKDDI_CONNECTDOORBELL DxgkddiConnectdoorbell;
NTSTATUS DxgkddiConnectdoorbell(
INOUT_PDXGKARG_CONNECTDOORBELL pArgs
)
{...}
Parámetros
pArgs
[in/out] Puntero a una estructura de DXGKARG_CONNECTDOORBELL que describe el timbre para conectarse.
Valor devuelto
DxgkDdiConnectDoorbell devuelve STATUS_SUCCESS si KMD pudo conectar correctamente su objeto doorbell a la cola de hardware especificada. Esta llamada no suele producir un error; sin embargo, un código de error devuelto sería de gpu perdida o detenida de tipos de escenarios irrecuperables.
Observaciones
Cuando UMD llama a D3DKMTConnectDoorbell, el sistema operativo llama a DxgkDdiConnectDoorbell para que el KMD pueda hacer lo siguiente:
- Proporcione una dirección virtual de CPU asignada a la ubicación del timbre físico.
- Realice las conexiones necesarias entre el objeto de cola de hardware, el objeto doorbell, la dirección física del timbre, el programador de GPU, etc.
Al volver de esta DDI, KMD debe considerar esta dirección física como reservada para esta cola de hardware determinada. Sin embargo, el sistema operativo no tiene un requisito de unicidad para la dirección física del timbre. Es decir, KMD puede optar por compartir la misma dirección física con varias colas lógicas de timbres o hardware en función de la implementación de hardware. Por ejemplo, algunos hardware pueden optar por asignar la misma dirección física a todas las colas de hardware de un único contexto de hardware. Incluso es posible que varios timbres lógicos compartan la misma página física de 4 KB, pero usen un desplazamiento único dentro de la página.
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 |