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 | Parameter wurden überprüft und ermittelt, dass sie falsch sind. |
Diese Funktion kann auch andere NTSTATUS- Werte zurückgeben.
Bemerkungen
Der Kernel steuert den Speicher, auf den durch den Anzeigekontext verwiesen wird, der durch die D3DKMTCreateDCFromMemory Funktion erstellt wurde. Sie müssen die D3DKMTDestroyDCFromMemory Funktion aufrufen, um den vom Anzeigekontext referenzierten Speicher freizugeben. Jeder andere Ansatz zum Freigeben dieses Speichers schlägt fehl.
Während der Ausführung der D3DKMTCreateDCFromMemory-Funktion sperrt und testet der Kernel den referenzierten Speicher, indem ein nicht threadsicherer Schreibzugriff auf jede Seite im Speicher ausgeführt wird. Für die Dauer des D3DKMTCreateDCFromMem ory-Aufrufs sollten keine anderen Threads in Ihrem Prozess versuchen, auf einen Teil dieses Speichers zuzugreifen; andernfalls werden die Ergebnisse nicht definiert.
Anforderungen
| Anforderung | Wert |
|---|---|
| mindestens unterstützte Client- | Windows Vista |
| Zielplattform- | Universal |
| Header- | d3dkmthk.h (einschließlich D3dkmthk.h) |