Compartilhar via

Requisitos específicos para provedores de página de propriedades do dispositivo (DLLs de extensão de página de propriedades)

  • Artigo

Este tópico mostra como criar e instalar uma DLL de extensão de página de propriedades.

Criando uma dll de extensão de página de propriedades

Uma DLL de extensão de página de propriedades que fornece páginas de propriedades personalizadas deve manipular a solicitação para adicionar uma página de propriedades. Essa solicitação é feita por meio da função de retorno de chamada AddPropSheetPageProc .

Em resposta a essa solicitação, a DLL fornece informações sobre cada uma de suas páginas de propriedades personalizadas, cria as páginas e adiciona as páginas criadas à lista de páginas de propriedades dinâmicas do dispositivo.

Para obter informações sobre como criar uma página de propriedades de dispositivo personalizada por uma DLL de extensão de página de propriedades, consulte Requisitos gerais para provedores de página de propriedades do dispositivo.

Instalando uma página de propriedades do dispositivo

Uma DLL de extensão de página de propriedades é instalada usando as seguintes diretivas no arquivo INF de um pacote de driver:

  1. Use a seção add-registry, que é especificada por uma diretiva INF AddReg na seção INF DDInstall, para adicionar uma entrada EnumPropPages32 para o dispositivo. A entrada EnumPropPages32 especifica os seguintes valores de REG_SZ :

    • O nome da DLL que exporta a função de retorno de chamada ExtensionPropSheetPageProc .
    • O nome da função de retorno de chamada ExtensionPropSheetPageProc conforme implementado pela DLL.

    O exemplo de código a seguir mostra uma seção add-registry que adiciona a entrada EnumPropPages32 que especifica o nome da DLL (MyPropProvider.dll) e da função de retorno de chamada (MyCallbackFunction):

    HKR, , EnumPropPages32, 0, "MyPropProvider.dll, MyCallbackFunction"

    Importante O nome da DLL e a função de retorno de chamada devem ser colocados entre aspas (" ").

  2. Inclua uma diretiva CopyFiles inf que copia a DLL da extensão da página de propriedades para o diretório %SystemRoot%\System32 .

  3. Se o dispositivo for um adaptador de rede, você deverá especificar NCF_HAS_UI como um dos valores características na seção INF DDInstall. Esse valor indica que o adaptador dá suporte a uma interface do usuário.

    Para obter mais informações, consulte Especificando páginas de propriedades personalizadas para adaptadores de rede.