VIDEO_PORT_AGP_INTERFACE_2 structure (video.h)

The VIDEO_PORT_AGP_INTERFACE_2 structure describes the AGP service routines provided by the video port driver.

Syntax

typedef struct _VIDEO_PORT_AGP_INTERFACE_2 {
  IN USHORT                  Size;
  IN USHORT                  Version;
  OUT PVOID                  Context;
  OUT PINTERFACE_REFERENCE   InterfaceReference;
  OUT PINTERFACE_DEREFERENCE InterfaceDereference;
  OUT PAGP_RESERVE_PHYSICAL  AgpReservePhysical;
  OUT PAGP_RELEASE_PHYSICAL  AgpReleasePhysical;
  OUT PAGP_COMMIT_PHYSICAL   AgpCommitPhysical;
  OUT PAGP_FREE_PHYSICAL     AgpFreePhysical;
  OUT PAGP_RESERVE_VIRTUAL   AgpReserveVirtual;
  OUT PAGP_RELEASE_VIRTUAL   AgpReleaseVirtual;
  OUT PAGP_COMMIT_VIRTUAL    AgpCommitVirtual;
  OUT PAGP_FREE_VIRTUAL      AgpFreeVirtual;
  OUT ULONGLONG              AgpAllocationLimit;
  OUT 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.

Remarks

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

See also

INTERFACE

VIDEO_PORT_AGP_INTERFACE

VideoPortQueryServices