Exemples de fonctions pour COPP

Cette section s’applique uniquement à Windows Server 2003 SP1 et versions ultérieures, ainsi qu’à Windows XP SP2 et versions ultérieures.

Les exemples de fonctions COPP montrent comment implémenter des fonctionnalités de traitement COPP. Ces exemples de fonctions mappent aux fonctions de rappel de compensation de mouvement définies dans la structure DD_MOTIONCOMPCALLBACKS . Vous pouvez implémenter chaque exemple de fonction et une demande de contrôle d’E/S COPP (IOCTL) correspondante, puis utiliser un modèle de code de compensation de mouvement et un modèle de pilote de miniport vidéo pour terminer l’implémentation. Pour plus d’informations, consultez Exemple de code pour les appareils DirectX VA.

Exemples de fonctions COPP

Les exemples de fonctions COPP dans le tableau suivant sont appelés à l’aide de l’appareil COPP. Pour plus d’informations sur l’appareil COPP, consultez Code de modèle de définition d’appareil COPP et Définition de la classe d’appareil COPP.

Fonction membre	Description
COPPOpenVideoSession	Initialise l’appareil COPP utilisé pour la session vidéo en cours.
COPPGetCertificateLength	Récupère la taille, en octets, du certificat utilisé par le matériel graphique.
COPPKeyExchange	Récupère le certificat numérique utilisé par le matériel graphique.
COPPSequenceStart	Définit la session vidéo active en mode protégé.
COPPCommand	Définit le niveau de protection sur le connecteur physique associé à l’appareil COPP.
COPPQueryStatus	Récupère status sur une session vidéo protégée associée à un appareil COPP.
COPPCloseVideoSession	Ferme l’objet de périphérique COPP et indique au pilote de libérer les ressources matérielles associées au périphérique COPP.

Mappage d’exemples de fonctions à DD_MOTIONCOMPCALLBACKS

Les exemples de fonctions de cette section sont mappés aux fonctions de rappel de compensation de mouvement à l’aide d’un IOCTL COPP, comme suit : autrement dit, chaque exemple de fonction est appelé dans son IOCTL COPP respectif, et chaque COPP IOCTL est passé à la fonction EngDeviceIoControl dans sa fonction de rappel de compensation de mouvement respective.

Fonction	IOCTL	DD_MOTIONCOMPCALLBACKS membre
COPPOpenVideoSession	IOCTL_COPP_OpenDevice	CreateMoComp
COPPGetCertificateLength	IOCTL_COPP_GetCertificateLength	RenderMoComp
COPPKeyExchange	IOCTL_COPP_KeyExchange	RenderMoComp
COPPSequenceStart	IOCTL_COPP_StartSequence	RenderMoComp
COPPCommand	IOCTL_COPP_Command	RenderMoComp
COPPQueryStatus	IOCTL_COPP_Status	RenderMoComp
COPPCloseVideoSession	IOCTL_COPP_CloseDevice	DestroyMoComp