Valeurs de retour pour DirectDraw

  • Article

Les tableaux suivants répertorient les valeurs qui peuvent être retournées par les fonctions fournies par le pilote DirectDraw. Les valeurs DDHAL_DRIVER_Xxx sont effectivement retournées dans la valeur de retour DWORD. La valeur DD_OK et les codes d’erreur DDERR_Xxx sont retournés dans le membre ddRVal de la structure vers laquelle pointe le paramètre de la fonction particulière.

Pour obtenir les codes d’erreur spécifiques que chaque fonction peut retourner, consultez les descriptions des fonctions dans la section de référence. Pour obtenir une liste complète des codes d’erreur et des valeurs de retour, reportez-vous aux fichiers d’en-tête DirectDraw ddraw.h et dxmini.h . Notez que les codes d’erreur sont représentés par des valeurs négatives et ne peuvent pas être combinés.

Une fonction dans un pilote DirectDraw doit retourner l’un des deux codes de retour : DDHAL_DRIVER_HANDLED ou DDHAL_DRIVER_NOTHANDLED. Si le pilote retourne DDHAL_DRIVER_HANDLED, il doit également retourner DD_OK ou l’un des codes d’erreur répertoriés dans ddraw.h. Une fonction dans un pilote DirectDraw peut retourner les codes du tableau suivant. Ces codes sont définis dans ddraw.h.

Code de retour Signification
DD_OK La demande s’est terminée avec succès.
DDHAL_DRIVER_HANDLED Le pilote a effectué l’opération et retourné un code de retour valide pour cette opération dans le membre ddrval de la structure passé au rappel du pilote. Si ce code est DD_OK, DirectDraw ou Direct3D exécute la fonction . Sinon, DirectDraw ou Direct3D retourne le code d’erreur fourni par le pilote et abandonne la fonction.
DDHAL_DRIVER_NOCKEYHW Le pilote d’affichage n’a pas pu gérer l’appel, car il n’a plus de ressources matérielles de clé de couleur.
DDHAL_DRIVER_NOTHANDLED Le pilote n’a aucun commentaire sur l’opération demandée. Si le pilote doit avoir implémenté un rappel particulier, DirectDraw ou Direct3D signale une condition d’erreur. Sinon, DirectDraw ou Direct3D gère l’opération comme si le rappel du pilote n’avait pas été défini en exécutant l’implémentation DirectDraw ou Direct3D indépendante du périphérique. DirectDraw et Direct3D ignorent généralement toute valeur retournée dans le membre ddrval de la structure de paramètre de ce rappel.
DDERR_GENERIC Il existe une condition d’erreur non définie.
DDERR_OUTOFCAPS Le matériel nécessaire à l’opération demandée a déjà été alloué.
DDERR_UNSUPPORTED L'opération n'est pas prise en charge.

Une fonction DxApi implémentée dans un pilote de miniport vidéo retourne l’un des codes du tableau suivant. Ces codes sont définis dans dxmini.h.

Code de retour Signification
DX_OK La demande s’est terminée avec succès.
DXERR_GENERIC Il existe une condition d’erreur non définie.
DXERR_OUTOFCAPS Le matériel nécessaire à l’opération demandée a déjà été alloué.
DXERR_UNSUPPORTED L'opération n'est pas prise en charge.