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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Header | d3dkmddi.h (include D3dkmddi.h) |