Windows Driver Kit: Display Devices
VIDEO_PORT_AGP_INTERFACE_2
The VIDEO_PORT_AGP_INTERFACE_2 structure describes the AGP service routines provided by the video port driver.
typedef struct _VIDEO_PORT_AGP_INTERFACE_2 {
SHORT Size;
SHORT Version;
PVOID Context;
PINTERFACE_REFERENCE InterfaceReference;
PINTERFACE_DEREFERENCE InterfaceDereference;
PAGP_RESERVE_PHYSICAL AgpReservePhysical;
PAGP_RELEASE_PHYSICAL AgpReleasePhysical;
PAGP_COMMIT_PHYSICAL AgpCommitPhysical;
PAGP_FREE_PHYSICAL AgpFreePhysical;
PAGP_RESERVE_VIRTUAL AgpReserveVirtual;
PAGP_RELEASE_VIRTUAL AgpReleaseVirtual;
PAGP_COMMIT_VIRTUAL AgpCommitVirtual;
PAGP_FREE_VIRTUAL AgpFreeVirtual;
ULONGLONG AgpAllocationLimit;
PAGP_SET_RATE AgpSetRate;
} VIDEO_PORT_AGP_INTERFACE_2, *PVIDEO_PORT_AGP_INTERFACE_2;
Members
- Size
- Specifies the size in bytes of this structure.
- Version
- Specifies the version of the interface to be returned by the video port driver. The current interface version is defined in video.h and has the form VIDEO_PORT_AGP_INTERFACE_N.
- Context
- Pointer to a video port driver-defined context for the interface.
- InterfaceReference
- Pointer to the video port driver-implemented reference routine for this interface.
- InterfaceDereference
- Pointer to the video port driver-implemented dereference routine for this interface.
- AgpReservePhysical
- Pointer to the video port driver-implemented AgpReservePhysical routine.
- AgpReleasePhysical
- Pointer to the video port driver-implemented AgpReleasePhysical routine.
- AgpCommitPhysical
- Pointer to the video port driver-implemented AgpCommitPhysical routine.
- AgpFreePhysical
- Pointer to the video port driver-implemented AgpFreePhysical routine.
- AgpReserveVirtual
- Pointer to the video port driver-implemented AgpReserveVirtual routine.
- AgpReleaseVirtual
- Pointer to the video port driver-implemented AgpReleaseVirtual routine.
- AgpCommitVirtual
- Pointer to the video port driver-implemented AgpCommitVirtual routine.
- AgpFreeVirtual
- Pointer to the video port driver-implemented AgpFreeVirtual routine.
- AgpAllocationLimit
- Specifies the maximum total number of bytes of AGP memory that a miniport driver can commit.
- AgpSetRate
- Pointer to the video port driver-implemented AgpSetRate routine.
Comments
PnP video miniport drivers that can use AGP must fill in the Size and Version members, and then call the VideoPortQueryServices function, which initializes the remaining members of this structure.
This structure is identical to the VIDEO_PORT_AGP_INTERFACE structure, except for the AgpSetRate member, which that structure lacks. Video miniport drivers should first attempt to use VIDEO_PORT_AGP_INTERFACE_2 in a call to VideoPortQueryServices. If that call fails, due to the fact that the AGP filter driver does not support the newer version of the AGP interface, the video miniport driver can make a second call to VideoPortQueryServices, this time passing a VIDEO_PORT_AGP_INTERFACE structure.
Requirements
Headers: Declared in video.h. Include video.h.
See Also
VideoPortQueryServices, INTERFACE, VIDEO_PORT_AGP_INTERFACE