struttura D3DKMT_CREATECONTEXT (d3dkmthk.h)

La struttura D3DKMT_CREATECONTEXT descrive un contesto di dispositivo in modalità kernel da creare.

Sintassi

typedef struct _D3DKMT_CREATECONTEXT {
  [in]  D3DKMT_HANDLE             hDevice;
  [in]  UINT                      NodeOrdinal;
  [in]  UINT                      EngineAffinity;
  [in]  D3DDDI_CREATECONTEXTFLAGS Flags;
  void                      D3DKMT_PTR(
    VOID               *unnamedParam1,
    pPrivateDriverData unnamedParam2
  );
  [in]  UINT                      PrivateDriverDataSize;
  [in]  D3DKMT_CLIENTHINT         ClientHint;
  [out] D3DKMT_HANDLE             hContext;
  void                      D3DKMT_PTR(
    VOID           *unnamedParam1,
    pCommandBuffer unnamedParam2
  );
  [out] UINT                      CommandBufferSize;
  void                      D3DKMT_PTR(
    D3DDDI_ALLOCATIONLIST *unnamedParam1,
    pAllocationList       unnamedParam2
  );
  [out] UINT                      AllocationListSize;
  void                      D3DKMT_PTR(
    D3DDDI_PATCHLOCATIONLIST *unnamedParam1,
    pPatchLocationList       unnamedParam2
  );
  [out] UINT                      PatchLocationListSize;
  [out] D3DGPU_VIRTUAL_ADDRESS    CommandBuffer;
} D3DKMT_CREATECONTEXT;

Members

[in] hDevice

Handle per il dispositivo in cui creare il contesto di dispositivo.

[in] NodeOrdinal

Indice in base zero del nodo su cui è pianificato il contesto.

[in] EngineAffinity

Affinità del motore per il contesto.

[in] Flags

Struttura D3DDDI_CREATECONTEXTFLAGS che indica, in flag di campo di bit, come creare il contesto.

void D3DKMT_PTR( VOID *unnamedParam1, pPrivateDriverData unnamedParam2)

[in] PrivateDriverDataSize

Dimensioni, in byte, dei dati privati a cui punta pPrivateDriverData .

[in] ClientHint

Valore tipizzato D3DKMT_CLIENTHINT che indica il tipo di client che crea il contesto. Nella tabella seguente sono elencati i valori possibili.

Valore	Significato
D3DKMT_CLIENTHINT_UNKNOWN (0)	Il client è sconosciuto.
D3DKMT_CLIENTHINT_OPENGL (1)	Il client è il runtime OpenGL.
D3DKMT_CLIENTHINT_CDD (2)	Questo valore è solo per uso interno. Non usare.
D3DKMT_CLIENTHINT_DX7 (7)	Il client è il runtime di Microsoft DirectX 7.0.
D3DKMT_CLIENTHINT_DX8 (8)	Il client è il runtime di DirectX 8.0.
D3DKMT_CLIENTHINT_DX9 (9)	Il client è il runtime di DirectX 9.0.
D3DKMT_CLIENTHINT_DX10 (10)	Il client è il runtime di DirectX 10.0.

[out] hContext

Handle per il contesto di dispositivo fornito dal sottosistema del kernel grafico DirectX (Dxgkrnl.sys) e restituito dalla chiamata alla funzione D3DKMTCreateContext .

void D3DKMT_PTR( VOID *unnamedParam1, pCommandBuffer unnamedParam2)

[out] CommandBufferSize

Dimensione, in byte, del blocco di memoria a cui pCommandBuffer punta. La funzione D3DKMTCreateContext restituisce questo valore di dimensione.

void D3DKMT_PTR( D3DDDI_ALLOCATIONLIST *unnamedParam1, pAllocationList unnamedParam2)

[out] AllocationListSize

Numero di elementi nella matrice di allocazioni a cui punta pAllocationList . Questa quantità di allocazioni è disponibile quando il sottosistema kernel grafico DirectX invia il buffer dei comandi a cui punta pCommandBuffer al driver miniport di visualizzazione.

La funzione D3DKMTCreateContext restituisce questo numero.

void D3DKMT_PTR( D3DDDI_PATCHLOCATIONLIST *unnamedParam1, pPatchLocationList unnamedParam2)

[out] PatchLocationListSize

Numero di elementi nell'elenco patch-location a cui pPatchLocationList punta. Questa quantità di posizioni patch è disponibile quando il sottosistema kernel grafico DirectX invia il buffer dei comandi a cui punta pCommandBuffer al driver miniport di visualizzazione.

La funzione D3DKMTCreateContext restituisce questo numero.

[out] CommandBuffer

Puntatore alla memoria del buffer dei comandi in cui OpenGL ICD inserisce i comandi. La funzione D3DKMTCreateContext restituisce questo puntatore alla memoria.

Requisiti

Client minimo supportato	Disponibile in Windows Vista e versioni successive dei sistemi operativi Windows.
Intestazione	d3dkmthk.h (include D3dkmthk.h)

Vedere anche

D3DDDI_ALLOCATIONLIST

D3DDDI_CREATECONTEXTFLAGS

D3DDDI_PATCHLOCATIONLIST

D3DKMTCreateContext