D3DKMTDestroyDoorbell-Funktion (d3dkmthk.h)

  • Artikel

Wichtig

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

D3DKMTDestroyDoorbell zerstört ein Türklingelobjekt.

Syntax

NTSTATUS D3DKMTDestroyDoorbell(
  D3DKMT_DESTROY_DOORBELL *unnamedParam1
);

Parameter

unnamedParam1

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

Rückgabewert

D3DKMTDestroyDoorbell gibt STATUS_SUCCESS zurück, wenn das Betriebssystem das Türklingelobjekt erfolgreich zerstört. Wenn hDoorbell auf eine gültige Türklingel 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 hRingBufferControl-Zuordnungen , die zu dieser Türklingel gehören.
  • Gibt die Zuordnung frei, auf die pDoorbellStatusCPUVirtualAddress verweist.
  • Gibt sowohl die Benutzermodus- als auch die Kernelmoduszuordnungen frei, auf die pDoorbellCPUVirtuslAddress verweist.
  • Ruft die [DxgkDdiDestroyDoorbell] von KMD auf, damit KMD die physische Türklingelposition trennen und seine Türklingelobjekte zerstören kann.

Das UMD darf das Handle nach dem Aufruf von D3DKMTDestroyDoorbell nicht verwenden.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) WIN11_FUTURE
Kopfzeile d3dkmthk.h

Weitere Informationen

D3DKMT_DESTROY_DOORBELL

D3DKMTCreateDoorbell