DXGKDDI_CREATEDOORBELL 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í.
El sistema operativo llama a la DxgkDdiCreateDoorbell de KMD función de devolución de llamada para crear un timbre para una cola de hardware.
Sintaxis
DXGKDDI_CREATEDOORBELL DxgkddiCreatedoorbell;
NTSTATUS DxgkddiCreatedoorbell(
INOUT_PDXGKARG_CREATEDOORBELL pArgs
)
{...}
Parámetros
pArgs
[in/out] Puntero a una estructura DXGKARG_CREATEDOORBELL que describe el timbre.
Valor devuelto
DxgkDdiCreateDoorbell devuelve STATUS_SUCCESS si KMD pudo crear correctamente su objeto de timbre para la cola de hardware especificada y UMD puede usar este timbre para el envío de trabajo. De lo contrario, devuelve un código de error NTSTATUS adecuado. UMD no puede usar el envío de timbre para el trabajo si KMD devuelve algún código de error.
Observaciones
Cuando UMD llama a D3DKMTCreateDoorbell para crear un timbre de puerta para una cola de hardware, el sistema operativo realiza un DxgkDdiCreateDoorbell llamada a KMD para que KMD pueda inicializar sus estructuras de timbre.
La función DxgkDdiCreateDoor bell de KMD solo debe crear e inicializar sus estructuras de datos de timbre. Aún no debe asignar una ubicación de timbre físico a este objeto de timbre, ya que se realiza durante una llamada posterior a DxgkDdiConnectDoorbell. Esta asignación diferida garantiza que no se use un timbre físico durante la creación de colas de hardware y de timbre, solo para ir desperdiciado en caso de que UMD nunca envíe comandos a él o empiece a enviar comandos más adelante. De esta manera, los timbres físicos solo se usan cuando realmente es necesario.
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 |