Note
Access to this page requires authorization. You can try signing in or changing directories.
Access to this page requires authorization. You can try changing directories.
The pfnAcquireNextFrequencyRangeInfo function returns the next frequency range descriptor in a monitor frequency range set, given the current frequency range descriptor.
Syntax
DXGKDDI_MONITORFREQUENCYRANGESET_ACQUIRENEXTFREQUENCYRANGEINFO DxgkddiMonitorfrequencyrangesetAcquirenextfrequencyrangeinfo;
NTSTATUS DxgkddiMonitorfrequencyrangesetAcquirenextfrequencyrangeinfo(
[in] IN_CONST_D3DKMDT_HMONITORFREQUENCYRANGESET hMonitorFrequencyRangeSet,
[in] IN_CONST_PD3DKMDT_MONITOR_FREQUENCY_RANGE_CONST pMonitorFrequencyRangeInfo,
[out] DEREF_OUT_CONST_PPD3DKMDT_MONITOR_FREQUENCY_RANGE ppNextMonitorFrequencyRangeInfo
)
{...}
Parameters
[in] hMonitorFrequencyRangeSet
A handle to a monitor frequency range set object. The display miniport driver previously obtained this handle by calling the pfnGetMonitorFrequencyRangeSet function of the Monitor Interface.
[in] pMonitorFrequencyRangeInfo
A pointer to a D3DKMDT_MONITOR_FREQUENCY_RANGE structure that is the current frequency range descriptor. The display miniport driver previously obtained this pointer by calling pfnAcquireFirstFrequencyRangeInfo or pfnAcquireNextFrequencyRangeInfo.
[out] ppNextMonitorFrequencyRangeInfo
A pointer to a variable that receives a pointer to a D3DKMDT_MONITOR_FREQUENCY_RANGE structure that is the next frequency range descriptor.
Return value
The pfnAcquireNextFrequencyRangeInfo function returns one of the following values.
| Return code | Description |
|---|---|
| STATUS_SUCCESS | The function successfully returned the next frequency range descriptor. |
| STATUS_GRAPHICS_DATASET_IS_EMPTY | The function succeeded, but there were no more frequency range descriptors in the set. |
| STATUS_INVALID_PARAMETER | An invalid parameter was supplied. |
| STATUS_INVALID_FREQUENCYRANGE | The frequency range descriptor supplied in pMonitorFrequencyRangeInfo was invalid. |
| STATUS_INVALID_MONITOR_FREQUENCYRANGESET | The handle supplied in hMonitorFrequencyRangeSet was invalid. |
This function might also return other error codes defined in Ntstatus.h.
Remarks
When you have finished using the D3DKMDT_MONITOR_FREQUENCY_RANGE structure, you must release the structure by calling pfnReleaseFrequencyRangeInfo.
You can obtain all the descriptors in a monitor frequency range set by calling pfnAcquireFirstFrequencyRangeInfo and then making a sequence of calls to pfnAcquireNextFrequencyRangeInfo.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows Vista |
| Target Platform | Desktop |
| Header | d3dkmddi.h (include D3dkmddi.h) |
| IRQL | PASSIVE_LEVEL |