D3DKMTCreateDCFromMemory-Funktion (d3dkmthk.h)

Die D3DKMTCreateDCFromMemory-Funktion erstellt einen Anzeigekontext aus einem angegebenen Speicherblock.

Syntax

NTSTATUS D3DKMTCreateDCFromMemory(
  D3DKMT_CREATEDCFROMMEMORY *unnamedParam1
);

Parameter

unnamedParam1

pData [ein, aus]

Ein Zeiger auf eine D3DKMT_CREATEDCFROMMEMORY Struktur, die Parameter zum Erstellen eines Anzeigekontexts beschreibt.

Rückgabewert

D3DKMTCreateDCFromMemory gibt einen der folgenden Werte zurück:

Rückgabecode	Beschreibung
STATUS_SUCCESS	Der Anzeigekontext wurde erfolgreich erstellt.
STATUS_INVALID_PARAMETER	Parameter wurden überprüft und als falsch ermittelt.

Diese Funktion kann auch andere NTSTATUS-Werte zurückgeben.

Hinweise

Der Kernel steuert den Arbeitsspeicher, auf den durch den Anzeigekontext verwiesen wird, der von der D3DKMTCreateDCFromMemory-Funktion erstellt wird. Sie müssen die D3DKMTDestoryDCFromMemory-Funktion aufrufen, um den Speicher freizugeben, auf den vom Anzeigekontext verwiesen wird. Jeder andere Ansatz zum Freigeben dieses Arbeitsspeichers schlägt fehl.

Während der Ausführung der D3DKMTCreateDCFromMemory-Funktion sperrt und testet der Kernel den referenzierten Arbeitsspeicher, indem er einen nicht threadsicheren Schreibvorgang auf jede Seite im Arbeitsspeicher ausführt. Keine anderen Threads in Ihrem Prozess sollten versuchen, für die Dauer des D3DKMTCreateDCFromMemory-Aufrufs auf einen Teil dieses Arbeitsspeichers zuzugreifen. andernfalls werden die Ergebnisse nicht definiert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista
Zielplattform	Universell
Header	d3dkmthk.h (einschließlich D3dkmthk.h)
Bibliothek	Gdi32.lib
DLL	Gdi32.dll

Weitere Informationen

D3DKMT_CREATEDCFROMMEMORY