Freigeben über

D3DKMTDestroyDoorbell-Funktion (d3dkmthk.h)

  • Artikel

Wichtig

Einige Informationen beziehen sich auf ein Vorabrelease-Produkt, das vor der kommerziellen Freigabe erheblich geändert werden kann. Microsoft übernimmt hinsichtlich der hier bereitgestellten Informationen keine Gewährleistungen, seien sie ausdrücklich oder konkludent.

D3DKMTDestroyDoorbell zerstört eine Türklingel.

Syntax

NTSTATUS D3DKMTDestroyDoorbell(
  D3DKMT_DESTROY_DOORBELL *unnamedParam1
);

Parameter

unnamedParam1

[in] Zeiger auf eine D3DKMT_DESTROY_DOORBELL Struktur, die die Hardwarewarteschlange identifiziert, deren Klingel zerstört werden soll.

Rückgabewert

D3DKMTDestroyDoorbell gibt STATUS_SUCCESS zurück, wenn das Betriebssystem das Klingelobjekt erfolgreich zerstört. Wenn hDoorbell auf eine gültige Klingel zeigt, ist dieser Aufruf immer erfolgreich; andernfalls wird STATUS_INVALID_PARAMETER zurückgegeben.

Hinweise

Wenn UMD D3DKMTDestroyDoorbell aufruft, führt das Betriebssystem folgendes aus:

  • Entfernt den Verweis auf hRingBuffer und auf hRingBufferControl-Zuordnungen , die zu dieser Türklingel gehören.
  • Gibt die Zuordnung frei, auf die DoorbellStatusCPUVirtualAddress verweist.
  • Gibt sowohl die Benutzermodus- als auch die Kernelmoduszuordnungen frei, auf die DoorbellCPUVirtuslAddress verweist.
  • Ruft die [DxgkDdiDestroyDoorbell] von KMD auf, damit KMD die physische Türklingelposition trennen und seine Türklingelobjekte zerstören kann.

Die UMD darf den Handle nach dem Aufruf von D3DKMTDestroyDoorbell nicht verwenden.

Weitere Informationen finden Sie unter Arbeitsübermittlung im Benutzermodus.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 11, Version 24H2 (WDDM 3.2)
Kopfzeile d3dkmthk.h

Weitere Informationen

D3DKMT_DESTROY_DOORBELL

D3DKMTCreateDoorbell