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 |