Compartilhar via

Método IMDServiceProvider2::CreateDevice (mswmdm.h)

  • Artigo

O método CreateDevice é chamado pela Gerenciador de Dispositivos do Windows Media para obter os objetos IMDSPDevice correspondentes ao dispositivo canônico obtido do subsistema PnP. Esse método deve ser implementado para suporte a PnP e Windows Explorer, mas, caso contrário, é opcional. Para obter mais informações, consulte Interfaces obrigatórias e opcionais.

Sintaxe

HRESULT CreateDevice(
  [in]  LPCWSTR     pwszDevicePath,
  [out] DWORD       *pdwCount,
  [out] IMDSPDevice ***pppDeviceArray
);

Parâmetros

[in] pwszDevicePath

Ponteiro para uma cadeia de caracteres nulos de caractere largo que contém o caminho do dispositivo detectado pelo Windows Media Gerenciador de Dispositivos. Esse nome é obtido do subsistema PnP e é o nome canônico mais "$ # ", em # que é um número incrementado automaticamente. Esse nome pode ser passado diretamente para funções como CreateFile para obter acesso ao objeto de dispositivo kernel subjacente. O provedor de serviços deve criar um objeto IMDSPDevice wrapper para este dispositivo.

[out] pdwCount

Ponteiro para um DWORD que contém o número de objetos IMDSPDevice criados.

[out] pppDeviceArray

Uma matriz de interfaces IMDSPDevice que representam os dispositivos. Normalmente, há apenas um elemento de matriz, mas um provedor de serviços pode criar mais de um objeto IMDSPDevice correspondente a um nome de caminho de dispositivo se ele criar um objeto IMDSPDevice para cada armazenamento de nível superior. Isso está sujeito a alterações no futuro e a contagem pode ser restrita a 1.

Retornar valor

Se o método for bem-sucedido, ele retornará S_OK. Se o método falhar, ele retornará os códigos de erro Gerenciador de Dispositivos do Windows Media.

Comentários

O Windows Media Gerenciador de Dispositivos chama esse método quando um aplicativo é iniciado ou quando um dispositivo compatível com Plug and Play se conecta com o computador.

Requisitos

Requisito Valor
Plataforma de Destino Windows
Cabeçalho mswmdm.h
Biblioteca Mssachlp.lib

Confira também

Enumerando dispositivos

IMDServiceProvider2 Interface