estrutura CONFLICT_DETAILS_A (cfgmgr32.h)

Artigo
11/20/2024

A estrutura CONFLICT_DETAILS é usada como um parâmetro para a função CM_Get_Resource_Conflict_Details.

Sintaxe

typedef struct _CONFLICT_DETAILS_A {
  ULONG   CD_ulSize;
  ULONG   CD_ulMask;
  DEVINST CD_dnDevInst;
  RES_DES CD_rdResDes;
  ULONG   CD_ulFlags;
  CHAR    CD_szDescription[MAX_PATH];
} CONFLICT_DETAILS_A, *PCONFLICT_DETAILS_A;

Membros

CD_ulSize

Tamanho, em bytes, da estrutura CONFLICT_DETAILS.

CD_ulMask

Um ou mais sinalizadores de bit fornecidos pelo chamador do CM_Get_Resource_Conflict_Details. Os sinalizadores de bits são descritos na tabela a seguir.

Bandeira	Descrição
CM_CDMASK_DEVINST	Se definido, CM_Get_Resource_Conflict_Details fornecerá um valor para o membro CD_dnDevInst.
CM_CDMASK_RESDES	Não usado.
CM_CDMASK_FLAGS	Se definido, CM_Get_Resource_Conflict_Details fornecerá um valor para o membro CD_ulFlags.
CM_CDMASK_DESCRIPTION	Se definido, CM_Get_Resource_Conflict_Details fornecerá um valor para o membro CD_szDescription.

CD_dnDevInst

Se CM_CDMASK_DEVINST estiver definido em CD_ulMask, esse membro receberá um identificador para uma instância de dispositivo que tenha recursos conflitantes. Se um identificador não for possível, o membro receberá -1.

CD_rdResDes

Não usado.

CD_ulFlags

Se CM_CDMASK_FLAGS estiver definido em CD_ulMask, esse membro poderá receber sinalizadores de bits listados na tabela a seguir.

Bandeira	Descrição
CM_CDFLAGS_DRIVER	Se definido, a cadeia de caracteres contida no membro CD_szDescription representará um nome de driver em vez de um nome de dispositivo e CD_dnDevInst será -1.
CM_CDFLAGS_ROOT_OWNED	Se definido, os recursos conflitantes pertencem ao dispositivo raiz (ou seja, o HAL) e CD_dnDevInst é -1.
CM_CDFLAGS_RESERVED	Se definido, o proprietário dos recursos conflitantes não poderá ser determinado e CD_dnDevInst será -1.

CD_szDescription[MAX_PATH]

Se CM_CDMASK_DESCRIPTION for definido em CD_ulMask, esse membro receberá uma cadeia de caracteres de texto terminada em NULL que representa uma descrição do dispositivo que possui os recursos. Se CM_CDFLAGS_DRIVER for definido em CD_ulFlags, essa cadeia de caracteres representará um nome de driver. Se CM_CDFLAGS_ROOT_OWNED ou CM_CDFLAGS_RESERVED estiver definido, o valor da cadeia de caracteres será NULL.

Observações

Nota

O cabeçalho cfgmgr32.h define CONFLICT_DETAILS como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante do pré-processador UNICODE. A combinação do uso do alias neutro de codificação com código que não é neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cabeçalho	cfgmgr32.h (inclua Cfgmgr32.h)

Consulte também

CM_Get_Resource_Conflict_Details

Compartilhar via