função de retorno de chamada SW_DEVICE_CREATE_CALLBACK (swdevice.h)

Fornece um dispositivo com suporte no registro e permite que o chamador faça chamadas para funções de API de Dispositivo de Software com o identificador hSwDevice .

Sintaxe

SW_DEVICE_CREATE_CALLBACK SwDeviceCreateCallback;

void SwDeviceCreateCallback(
  [in]           HSWDEVICE hSwDevice,
  [in]           HRESULT CreateResult,
  [in, optional] PVOID pContext,
  [in, optional] PCWSTR pszDeviceInstanceId
)
{...}

Parâmetros

[in] hSwDevice

O identificador do dispositivo de software.

[in] CreateResult

Um HRESULT que indica se a enumeração do dispositivo de software foi bem-sucedida.

[in, optional] pContext

O contexto que foi opcionalmente fornecido pelo aplicativo cliente para SwDeviceCreate.

[in, optional] pszDeviceInstanceId

A ID da instância do dispositivo que o PnP atribuiu ao dispositivo.

Retornar valor

Nenhum

Comentários

O sistema operacional chama a função de retorno de chamada SW_DEVICE_CREATE_CALLBACK após o PnP enumerar o dispositivo. Depois que a função de retorno de chamada é chamada, o dispositivo tem suporte no registro e as chamadas para funções de API de Dispositivo de Software podem ser feitas usando o identificador hSwDevice . Você também pode usar outras APIs que funcionam com dispositivos para o dispositivo criado.

A enumeração PnP de um dispositivo é a primeira etapa pela qual um dispositivo passa. Após a enumeração PnP do dispositivo, o dispositivo só tem suporte do Registro e você pode definir propriedades em relação ao dispositivo. Só porque o PnP enumerou o dispositivo, o dispositivo ainda não foi iniciado e nenhum driver para o dispositivo registrou ou habilitou interfaces ainda. Em muitos casos, recomendamos que os aplicativos aguardem a chegada da interface do dispositivo se quiserem usar o dispositivo.

Nota A função de retorno de chamada fornece a ID da instância do dispositivo para o dispositivo criado. Recomendamos que os chamadores da API de Dispositivo de Software não tentem adivinhar ou construir a ID da instância do dispositivo por conta própria; sempre use o valor fornecido pela função de retorno de chamada.

 

A função de retorno de chamada será executada em um thread arbitrário do pool de threads. Os aplicativos cliente podem executar o máximo de trabalho necessário na função de retorno de chamada.

Em Windows 8, você não pode chamar SwDeviceClose dentro da função de retorno de chamada. Isso causará um deadlock. Tenha cuidado ao liberar um objeto ref counted que chamará SwDeviceClose quando seu destruidor for executado. Em Windows 8.1, essa restrição é levantada e você pode chamar SwDeviceClose dentro da função de retorno de chamada.

Sempre marcar o HRESULT que é passado para CreateResult para garantir que o PnP foi capaz de enumerar o dispositivo.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8
Servidor mínimo com suporte	Windows Server 2012
Plataforma de Destino	Área de Trabalho
Cabeçalho	swdevice.h

Confira também

SwDeviceCreate