DXGKDDI_ISSUPPORTEDVIDPN callback function (d3dkmddi.h)
The DxgkDdiIsSupportedVidPn function determines whether a specified VidPN is supported on a display adapter.
Syntax
DXGKDDI_ISSUPPORTEDVIDPN DxgkddiIssupportedvidpn;
NTSTATUS DxgkddiIssupportedvidpn(
[in] IN_CONST_HANDLE hAdapter,
[in, out] INOUT_PDXGKARG_ISSUPPORTEDVIDPN pIsSupportedVidPn
)
{...}
Parameters
[in] hAdapter
A handle to a context block associated with a display adapter. The display miniport driver previously provided this handle to the DirectX graphics kernel subsystem in the MiniportDeviceContext output parameter of the DxgkDdiAddDevice function.
[in, out] pIsSupportedVidPn
A pointer to a DXGKARG_ISSUPPORTEDVIDPN structure. On input, the caller supplies the hDesiredVidPn member of the structure. On return, the IsVidPnSupported member receives a Boolean value that indicates whether the VidPN is supported (TRUE) or not supported (FALSE).
Return value
DxgkDdiIsSupportedVidPn returns one of the following values
| Return code | Description |
|---|---|
| STATUS_SUCCESS | The topology of the VidPN is valid. The IsVidPnSupported structure member is set to either TRUE or FALSE. |
| STATUS_GRAPHICS_INVALID_VIDPN_TOPOLOGY | The topology of the VidPN implementation is invalid. The IsVidPnSupported structure member is set to FALSE. |
| STATUS_NO_MEMORY | The function failed because it was unable to allocate memory. |
Remarks
For more information about the analysis that this function must perform, see Determining Whether a VidPN is Supported on a Display Adapter.
If pIsSupportedVidPnArg->hDesiredVidPn is zero, DxgkDdiIsSupportedVidPn must set pIsSupportedVidPnArg->IsVidPnSupported to TRUE, the idea being that the display adapter can always be configured to display nothing.
DxgkDdiIsSupportedVidPn should be made pageable.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Target Platform | Desktop |
| Header | d3dkmddi.h |
| IRQL | PASSIVE_LEVEL |