DXGKARG_SETVIDPNSOURCEADDRESS structure (d3dkmddi.h)

The DXGKARG_SETVIDPNSOURCEADDRESS structure contains arguments for the DxgkDdiSetVidPnSourceAddress function.

Syntax

typedef struct _DXGKARG_SETVIDPNSOURCEADDRESS {
       D3DDDI_VIDEO_PRESENT_SOURCE_ID   VidPnSourceId;
       UINT                             PrimarySegment;
       PHYSICAL_ADDRESS                 PrimaryAddress;
  [in] HANDLE                           hAllocation;
  [in] UINT                             ContextCount;
       HANDLE                           Context[1 + D3DDDI_MAX_BROADCAST_CONTEXT];
  [in] DXGK_SETVIDPNSOURCEADDRESS_FLAGS Flags;
       UINT                             Duration;
       DXGK_PRIMARYDATA                 PrimaryData[D3DDDI_MAX_BROADCAST_CONTEXT];
       UINT                             DriverPrivateDataSize;
       PVOID                            pDriverPrivateData;
} DXGKARG_SETVIDPNSOURCEADDRESS;

Members

VidPnSourceId

An integer that identifies a video present source on the display adapter.

PrimarySegment

The identifier of the segment that contains the source's primary surface.

PrimaryAddress

The address, within the segment identified by PrimarySegment, of the source's primary surface.

[in] hAllocation

If non-NULL, a handle that the display miniport driver assigned to the allocation and returned from its call to the DxgkDdiCreateAllocation function. The driver must reprogram graphics hardware according to the specific private properties of the allocation, which include but are not limited to pitch size, swizzle format, and so on.

[in] ContextCount

The number of contexts in the array that the Context member specifies.

[in] Context[1 + D3DDDI_MAX_BROADCAST_CONTEXT]

An array of handles to the contexts that contributed to a display operation.

[in] Flags

A DXGK_SETVIDPNSOURCEADDRESS_FLAGS structure that identifies the type of display operation to perform.

Duration

The length of time, in units of 100 nanoseconds, between when the current present operation flips to the screen and the next vertical blanking interrupt occurs.

If zero, the refresh rate should be the default rate based on the current mode.

Must be supported by WDDM 1.3 and later drivers. Available starting with Windows 8.1.

PrimaryData[D3DDDI_MAX_BROADCAST_CONTEXT]

DriverPrivateDataSize

pDriverPrivateData

Remarks

For display mode-switch operations, the ContextCount member is always set to 0 and the content of the Context array is undefined. When a flip operation is performed, ContextCount is set to the number of contexts that contributed to the flip. If a flip operation is broadcast to three contexts, ContextCount is set to 4 (that is, the original context plus three broadcast contexts). The Context array contains the driver context handles for the contexts that contributed to the flip operation.

Requirements

See also

DXGK_SETVIDPNSOURCEADDRESS_FLAGS

DxgkDdiCreateAllocation

DxgkDdiSetVidPnSourceAddress