PFND3DDDI_GETPITCH fonction de rappel (d3dumddi.h)
La fonction GetPitch récupère le pitch d’une surface protégée ou non verrouillable.
Syntaxe
PFND3DDDI_GETPITCH Pfnd3dddiGetpitch;
HRESULT Pfnd3dddiGetpitch(
HANDLE hDevice,
D3DDDIARG_GETPITCH *unnamedParam2
)
{...}
Paramètres
hDevice
Handle de l’appareil d’affichage (contexte graphique).
unnamedParam2
pData [in, out]
Pointeur vers une structure D3DDDIARG_GETPITCH qui décrit la surface protégée.
Valeur retournée
La fonction GetPitch retourne l’une des valeurs suivantes :
| Code de retour | Description |
|---|---|
| S_OK | Le pitch de la surface protégée est récupéré avec succès. |
| D3DDDIERR_NOTAVAILABLE | Le pilote ne prend pas en charge la fonction GetPitch. |
Remarques
Le matériel et les pilotes peuvent éventuellement prendre en charge la fonction GetPitch .
La surface pour laquelle la fonction GetPitch retourne le pitch peut être non verrouillable ou protégée. Par conséquent, l’application ne peut pas récupérer le pitch de la surface via un appel à la fonction Lock du pilote. L’application doit récupérer le pitch de la surface pour allouer correctement la mémoire tampon système que l’application utilise par la suite dans les appels aux fonctions EncryptionBlt et DecryptionBlt du pilote.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | GetPitch est pris en charge à partir du système d’exploitation Windows 7. |
| Plateforme cible | Desktop (Expérience utilisateur) |
| En-tête | d3dumddi.h (inclure D3dumddi.h) |