PFND3DDDI_GETPITCH fonction de rappel (d3dumddi.h)
La fonction GetPitch récupère la hauteur d’une surface protégée ou non verrouillée.
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 de retour
La fonction GetPitch retourne l’une des valeurs suivantes :
| Retourner le code | Description |
|---|---|
| S_OK | La hauteur de la surface protégée est récupérée 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 la hauteur peut être non verrouillée ou protégée. Par conséquent, l’application ne peut pas récupérer l’emplacement de la surface par le biais d’un appel à la fonction Lock du pilote. L’application doit récupérer l’emplacement de la surface pour allouer correctement la mémoire tampon de mémoire système utilisée par l’application par la suite dans les appels aux fonctions EncryptionBlt du pilote et fonctions DecryptionBlt.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | GetPitch est pris en charge à partir du système d’exploitation Windows 7. |
| plateforme cible | Bureau |
| d’en-tête | d3dumddi.h (include D3dumddi.h) |