Funzioni di esempio per COPP

Questa sezione si applica solo a Windows Server 2003 SP1 e versioni successive e Windows XP SP2 e versioni successive.

Le funzioni COPP di esempio illustrano come implementare la funzionalità di elaborazione COPP. Queste funzioni di esempio eseguono il mapping alle funzioni di callback di compensazione del movimento definite nella struttura DD_MOTIONCOMPCALLBACKS . È possibile implementare ogni funzione di esempio e una richiesta di I/O COPP (IOCTL) corrispondente e quindi usare un modello di codice di compensazione movimento e un modello di driver miniport video per completare l'implementazione. Per altre informazioni, vedere Codice di esempio per dispositivi DIRECTX VA.

Funzioni di esempio COPP

Le funzioni COPP di esempio nella tabella seguente vengono chiamate usando il dispositivo COPP. Per altre informazioni sul dispositivo COPP, vedere Codice del modello di definizione del dispositivo COPP e Definizione della classe di dispositivo COPP.

Funzione membro	Descrizione
COPPOpenVideoSession	Inizializza il dispositivo COPP utilizzato per la sessione video corrente.
COPPGetCertificateLength	Recupera le dimensioni, in byte, del certificato utilizzato dall'hardware grafico.
COPPKeyExchange	Recupera il certificato digitale utilizzato dall'hardware grafico.
COPPSequenceStart	Imposta la sessione video corrente sulla modalità protetta.
COPPCommand	Imposta il livello di protezione sul connettore fisico associato al dispositivo COPP.
COPPQueryStatus	Recupera lo stato in una sessione video protetta associata a un dispositivo COPP.
COPPCloseVideoSession	Chiude l'oggetto dispositivo COPP e indica al driver di rilasciare le risorse hardware associate al dispositivo COPP.

Mapping di funzioni di esempio a DD_MOTIONCOMPCALLBACKS

Le funzioni di esempio di questa sezione sono mappate alle funzioni di callback di compensazione del movimento usando un IOCTL COPP, come indicato di seguito; ovvero, ogni funzione di esempio viene chiamata all'interno del rispettivo IOCTL COPP e ogni IOCTL COPP viene passato alla funzione EngDeviceIoControl all'interno della rispettiva funzione di callback di compensazione del movimento.

Funzione	IOCTL	membro DD_MOTIONCOMPCALLBACKS
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