D3DDDIARG_CREATEDEVICE structure (d3dumddi.h)
La structure D3DDDIARG_CREATEDEVICE contient des informations qui décrivent le périphérique d’affichage à créer.
Syntaxe
typedef struct _D3DDDIARG_CREATEDEVICE {
[in/out] HANDLE hDevice;
[in] UINT Interface;
[in] UINT Version;
[in] const D3DDDI_DEVICECALLBACKS *pCallbacks;
[in] VOID *pCommandBuffer;
[in] UINT CommandBufferSize;
[in] D3DDDI_ALLOCATIONLIST *pAllocationList;
[in] UINT AllocationListSize;
[in] D3DDDI_PATCHLOCATIONLIST *pPatchLocationList;
[in] UINT PatchLocationListSize;
D3DDDI_DEVICEFUNCS *pDeviceFuncs;
[in] D3DDDI_CREATEDEVICEFLAGS Flags;
D3DGPU_VIRTUAL_ADDRESS CommandBuffer;
} D3DDDIARG_CREATEDEVICE;
Membres
[in/out] hDevice
Handle pour le périphérique d’affichage (contexte graphique). Lors de l’entrée dans la fonction CreateDevice , hDevice spécifie le handle que le pilote doit utiliser lorsqu’il rappelle le runtime Microsoft Direct3D.
Le pilote génère un handle unique et le transmet au runtime Direct3D. Lors de la sortie de la fonction CreateDevice , hDevice spécifie le handle que le runtime Direct3D utilise dans les appels de pilotes suivants pour identifier le périphérique d’affichage.
[in] Interface
Version de l’interface Direct3D/DirectDraw (par exemple, 7, 8 ou 9) qui crée l’appareil.
[in] Version
Nombre que le pilote peut utiliser pour identifier la date de création du runtime Direct3D/DirectDraw. Par exemple, le pilote peut utiliser le numéro de version pour faire la différence entre un runtime publié avec Windows Vista et un runtime publié avec un Service Pack ultérieur, qui peut contenir un correctif requis par le pilote.
[in] pCallbacks
Pointeur vers une structure D3DDDI_DEVICECALLBACKS qui contient une table de fonctions de rappel du runtime Direct3D que le pilote peut utiliser.
[in] pCommandBuffer
Obsolète. Pour recevoir un pointeur vers la première mémoire tampon que le pilote d’affichage en mode utilisateur peut utiliser pour les commandes de traitement par lot, le pilote doit d’abord appeler la fonction pfnCreateContextCb afin de créer un contexte pour l’appareil nouvellement créé.
[in] CommandBufferSize
Obsolète.
[in] pAllocationList
Obsolète. Pour recevoir un tableau de structures D3DDDI_ALLOCATIONLIST pour la liste d’allocation de départ, le pilote doit d’abord appeler la fonction pfnCreateContextCb afin de créer un contexte pour l’appareil nouvellement créé.
[in] AllocationListSize
Obsolète.
[in] pPatchLocationList
Obsolète. Pour recevoir un tableau de structures D3DDDI_PATCHLOCATIONLIST pour la liste d’emplacements du correctif de départ, le pilote doit d’abord appeler la fonction pfnCreateContextCb afin de créer un contexte pour l’appareil nouvellement créé.
[in] PatchLocationListSize
Obsolète.
pDeviceFuncs
[out] Pointeur vers une structure D3DDDI_DEVICEFUNCS que le pilote d’affichage en mode utilisateur remplit avec un tableau de ses fonctions. Le runtime Direct3D utilise ces fonctions pour communiquer avec le pilote d’affichage en mode utilisateur.
[in] Flags
Structure D3DDDI_CREATEDEVICEFLAGS qui identifie comment créer l’appareil.
CommandBuffer
Ce membre est réservé et doit être défini sur zéro.
Ce membre est disponible à partir de Windows 7.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Disponible dans Windows Vista et versions ultérieures des systèmes d’exploitation Windows. |
| En-tête | d3dumddi.h (inclure D3dumddi.h) |