Funciones de ejemplo para COPP

Esta sección solo se aplica a Windows Server 2003 SP1 y versiones posteriores, y Windows XP SP2 y versiones posteriores.

Las funciones COPP de ejemplo muestran cómo implementar la funcionalidad de procesamiento de COPP. Estas funciones de ejemplo se asignan a las funciones de devolución de llamada de compensación de movimiento definidas en la estructura DD_MOTIONCOMPCALLBACKS . Puede implementar cada función de ejemplo y una solicitud de control de E/S copP (IOCTL) correspondiente y, a continuación, usar una plantilla de código de compensación de movimiento y una plantilla de controlador de minipuerto de vídeo para completar la implementación. Para obtener más información, vea Ejemplo de código para dispositivos de DIRECTX VA.

Funciones de ejemplo de COPP

Se llama a las funciones COPP de ejemplo de la tabla siguiente mediante el dispositivo COPP. Para obtener más información sobre el dispositivo COPP, vea COPP Device Definition Template Code (Código de plantilla de definición de dispositivo COPP ) y Define the COPP Device Class (Definición de la clase de dispositivo COPP).

Función miembro	Descripción
COPPOpenVideoSession	Inicializa el dispositivo COPP usado para la sesión de vídeo actual.
COPPGetCertificateLength	Recupera el tamaño, en bytes, del certificado utilizado por el hardware gráfico.
COPPKeyExchange	Recupera el certificado digital utilizado por el hardware gráfico.
COPPSequenceStart	Establece la sesión de vídeo actual en modo protegido.
COPPCommand	Establece el nivel de protección en el conector físico asociado al dispositivo COPP.
COPPQueryStatus	Recupera el estado de una sesión de vídeo protegida asociada a un dispositivo COPP.
COPPCloseVideoSession	Cierra el objeto de dispositivo COPP e indica al controlador que libere los recursos de hardware asociados al dispositivo COPP.

Asignación de funciones de ejemplo a DD_MOTIONCOMPCALLBACKS

Las funciones de ejemplo de esta sección se asignan a las funciones de devolución de llamada de compensación de movimiento mediante un IOCTL copP, como se indica a continuación; es decir, cada función de ejemplo se llama dentro de su IOCTL copP correspondiente, y cada IOCTL copP se pasa a la función EngDeviceIoControl dentro de su respectiva función de devolución de llamada de compensación de movimiento.

Función	IOCTL	DD_MOTIONCOMPCALLBACKS miembro
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