Compartir a través de

Función D3DKMTDestroyDoorbell (d3dkmthk.h)

  • Artículo

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

Consulte también

D3DKMT_DESTROY_DOORBELL

D3DKMTCreateDoorbell