EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 função de retorno de chamada (iddcx.h)
O sistema operacional chama EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 para obter uma lista de modos de destino compatíveis com o driver para um monitor conectado ao ponto de extremidade. Esse retorno de chamada é semelhante a EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES, mas permite que o driver relate informações adicionais para os modos de destino HDR10 e WCG.
Sintaxe
EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 EvtIddCxMonitorQueryTargetModes2;
NTSTATUS EvtIddCxMonitorQueryTargetModes2(
IDDCX_MONITOR MonitorObject,
const IDARG_IN_QUERYTARGETMODES2 *pInArgs,
IDARG_OUT_QUERYTARGETMODES *pOutArgs
)
{...}
Parâmetros
MonitorObject
[in] O identificador de contexto gerado pelo sistema operacional que identifica o monitor para o qual gerar uma lista de modos de destino. Esse objeto IDDCX_MONITOR foi retornado em uma chamada anterior para IddCxMonitorCreate.
pInArgs
[in] Ponteiro para uma estrutura de IDARG_IN_QUERYTARGETMODES2 que contém argumentos de entrada usados por EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2.
pOutArgs
[out] Ponteiro para uma estrutura de IDARG_OUT_QUERYTARGETMODES que contém argumentos de saída gerados por EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2.
Retornar valor
EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES2 retorna um valor NTSTATUS . Se a operação for bem-sucedida, ela retornará STATUS_SUCCESS ou outro valor de status para o qual NT_SUCCESS(status) é igual a TRUE. Caso contrário, ele retornará um código de erro NTSTATUS apropriado.
Comentários
Essa função é semelhante a EVT_IDD_CX_PARSE_MONITOR_DESCRIPTION2 , pois permite que os drivers relatem as mesmas informações de modo extra. Um driver que dá suporte ao HDR deve implementar essa função; Drivers que não dão suporte ao HDR podem expor apenas a função EVT_IDD_CX_MONITOR_QUERY_TARGET_MODES existente.
O campo IDDCX_TARGET_MODE2::BitsPerComponent permite que vários formatos e profundidades de bits sejam relatados em um único modo. Por exemplo, um driver pode relatar 8 e 10 bits por componente em RGB definindo IDDCX_BITS_PER_COMPONENT_8 e IDDCX_BITS_PER_COMPONENT_10 em IDDCX_TARGET_MODE2::BitsPerComponent::Rgb. Um driver só deve relatar bits diferentes por componente como modos exclusivos se outros detalhes do modo também forem diferentes.
Os drivers que retornam modos com parâmetros SDR WCG ou HDR falharão se também não tiverem relatado IDDCX_ADAPTER_FLAGS_CAN_PROCESS_FP16 na chamada IddCxAdapterInitAsync . WCG SDR e IDDCX_WIRE_BITS_PER_COMPONENT HDR . Os parâmetros BitsPerComponent são:
- Qualquer valor para Rgb diferente de IDDCX_BITS_PER_COMPONENT_8 ou
- Qualquer valor para YCbCr444, YCbCr422 ou YCbCr420 diferente de IDDCX_BITS_PER_COMPONENT_NONE.
Para obter mais informações sobre o suporte a HDR, consulte Atualizações do IddCx versão 1.10.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows 11, versão 22H2 Atualização de setembro (IddCx versão 1.10) |
| Cabeçalho | iddcx.h |