Skip to content

Latest commit

 

History

History
48 lines (35 loc) · 2.39 KB

calling-the-copp-ddi-from-the-display-driver.md

File metadata and controls

48 lines (35 loc) · 2.39 KB
Raw
title description keywords ms.date
Calling the COPP DDI from the Display Driver
Calling the COPP DDI from the Display Driver
calling COPP DDI WDK DirectX VA
COPP WDK DirectX VA , calling from the display driver
04/20/2017

Calling the COPP DDI from the Display Driver

This section applies only to Windows Server 2003 SP1 and later, and Windows XP SP2 and later.

The display driver initiates calls to the video miniport driver's COPP DDI by using COPP I/O control (IOCTL) requests. The display driver calls the EngDeviceIoControl function by using a COPP IOCTL to send a synchronous COPP request to the video miniport driver. Graphics Device Interface (GDI) uses a single buffer for both input and output to pass the request to the I/O subsystem. The I/O subsystem routes the request to the video port, which processes the request by using the video miniport driver.

The following sample data structure and IOCTLs can be used to transfer COPP information between the display driver and the video miniport driver. Your drivers can either use the data structure and IOCTLs or create new ones, as appropriate.

typedef struct {
    PVOID* ppThis;
    PVOID InputBuffer;
    HRESULT phr;
} COPP_IO_InputBuffer;

#define IOCTL_COPP_OpenDevice \
        CTL_CODE(FILE_DEVICE_VIDEO, 2190, METHOD_BUFFERED, FILE_ANY_ACCESS)
#define IOCTL_COPP_CloseDevice \
        CTL_CODE(FILE_DEVICE_VIDEO, 2191, METHOD_BUFFERED, FILE_ANY_ACCESS)
#define IOCTL_COPP_GetCertificateLength \
        CTL_CODE(FILE_DEVICE_VIDEO, 2192, METHOD_BUFFERED, FILE_ANY_ACCESS)
#define IOCTL_COPP_KeyExchange \
        CTL_CODE(FILE_DEVICE_VIDEO, 2193, METHOD_BUFFERED, FILE_ANY_ACCESS)
#define IOCTL_COPP_StartSequence \
        CTL_CODE(FILE_DEVICE_VIDEO, 2194, METHOD_BUFFERED, FILE_ANY_ACCESS)
#define IOCTL_COPP_Command \
        CTL_CODE(FILE_DEVICE_VIDEO, 2195, METHOD_BUFFERED, FILE_ANY_ACCESS)
#define IOCTL_COPP_Status \
        CTL_CODE(FILE_DEVICE_VIDEO, 2196, METHOD_BUFFERED, FILE_ANY_ACCESS)

If you do not use the preceding IOCTLs, then you can define your own private IOCTLs, which must be formatted as described in Defining I/O Control Codes.