PFND3DKMT_CREATEDCFROMMEMORY Rückruffunktion (d3dkmthk.h)
Die D3DKMTCreateDCFromMemory-Funktion erstellt einen Anzeigekontext aus einem angegebenen Speicherblock.
Syntax
PFND3DKMT_CREATEDCFROMMEMORY Pfnd3dkmtCreatedcfrommemory;
NTSTATUS Pfnd3dkmtCreatedcfrommemory(
D3DKMT_CREATEDCFROMMEMORY *unnamedParam1
)
{...}
Parameter
unnamedParam1
pData [in, out]
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 | Die Parameter wurden überprüft und als falsch ermittelt. |
Diese Funktion gibt möglicherweise auch andere NTSTATUS-Werte zurück.
Hinweise
Der Kernel steuert den Speicher, auf den durch den Anzeigekontext verwiesen wird, der von der Funktion D3DKMTCreateDCFromMemory erstellt wurde. Sie müssen die Funktion D3DKMTDestoryDCFromMemory aufrufen, um den Speicher freizugeben, auf den der Anzeigekontext verweist. Jeder andere Ansatz zum Freigeben dieses Arbeitsspeichers schlägt fehl.
Während der Ausführung der D3DKMTCreateDCFromMemory-Funktion sperrt und testet der Kernel den arbeitsspeicher, auf den verwiesen wird, 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 (include D3dkmthk.h) |