Método IMDServiceProvider2::CreateDevice (mswmdm.h)
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 |