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 publicación comercial. Microsoft no ofrece ninguna garantía, expresa 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 se va a destruir.
Valor devuelto
D3DKMTDestroyDoorbell devuelve STATUS_SUCCESS cuando el sistema operativo destruye correctamente el objeto doorbell. Si hDoorbell apunta a un timbre válido, esta llamada siempre se realiza correctamente; de lo contrario, devuelve STATUS_INVALID_PARAMETER.
Observaciones
Cuando UMD llama D3DKMTDestroyDoorbell, el sistema operativo hace lo siguiente:
- Quita su referencia a hRingBuffer y a hRingBufferControl asignaciones que pertenecen a este timbre.
- Libera la asignación a la que apunta DoorbellStatusCPUVirtualAddres s.
- Libera tanto las asignaciones en modo de usuario como en modo kernel a las que apunta DoorbellCPUVirtuslAddress.
- Llama a kmD [DxgkDdiDestroyDoorbell] 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, 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 | d3dkmthk.h |