Función D3DKMTDestroyDoorbell (d3dkmthk.h)
Importante
Cierta información se relaciona con un producto de versión preliminar que puede modificarse sustancialmente antes de su lanzamiento comercial. Microsoft no otorga ninguna garantía, explícita o implícita, con respecto a la información proporcionada aquí.
D3DKMTDestroyDoorbell destruye un timbre.
Sintaxis
NTSTATUS D3DKMTDestroyDoorbell(
D3DKMT_DESTROY_DOORBELL *unnamedParam1
);
Parámetros
unnamedParam1
[in] Puntero a una estructura de D3DKMT_DESTROY_DOORBELL que identifica la cola de hardware cuyo timbre de puerta se va a destruir.
Valor devuelto
D3DKMTDestroyDoorbell devuelve STATUS_SUCCESS cuando el sistema operativo destruye correctamente el objeto de timbre. Si hDoorbell apunta a un timbre de puerta válido, esta llamada siempre se realiza correctamente; de lo contrario, devuelve STATUS_INVALID_PARAMETER.
Comentarios
Cuando UMD llama a D3DKMTDestroyDoorbell, el sistema operativo hace lo siguiente:
- Quita su referencia a hRingBuffer y a las asignaciones hRingBufferControl que pertenecen a este timbre.
- Libera la asignación a la que apunta DoorbellStatusCPUVirtualAddress .
- Libera tanto las asignaciones en modo de usuario como en modo kernel a las que DoorbellCPUVirtuslAddress apunta.
- Llama a la [DxgkDdiDestroyDoorbell] de KMD para que KMD pueda desconectar la ubicación física del timbre y destruir sus objetos de timbre.
El UMD no debe usar el identificador después de llamar a D3DKMTDestroyDoorbell.
Para obtener más información, vea Envío de trabajo en modo de usuario.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows 11, versión 24H2 (WDDM 3.2) |
| Encabezado | d3dkmthk.h |