Share via

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

  • Artículo

La Administrador de dispositivos de Windows Media llama al método CreateDevice para obtener los objetos IMDSPDevice correspondientes al dispositivo canónico obtenido del subsistema PnP. Este método debe implementarse para la compatibilidad con PnP y el Explorador de Windows, pero de lo contrario es opcional. Para obtener más información, consulte Interfaces obligatorias y opcionales.

Sintaxis

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

Parámetros

[in] pwszDevicePath

Puntero a una cadena terminada en null de caracteres anchos que contiene la ruta de acceso del dispositivo detectada por Windows Media Administrador de dispositivos. Este nombre se obtiene del subsistema PnP y es el nombre canónico más "$ # ", donde # es un número incrementado automáticamente. Este nombre se puede pasar directamente a funciones como CreateFile para obtener acceso al objeto de dispositivo kernel subyacente. El proveedor de servicios debe crear un objeto IMDSPDevice contenedor para este dispositivo.

[out] pdwCount

Puntero a un DWORD que contiene el número de objetos IMDSPDevice que se crean.

[out] pppDeviceArray

Matriz de interfaces IMDSPDevice que representan los dispositivos. Normalmente, solo hay un elemento de matriz, pero un proveedor de servicios puede crear más de un objeto IMDSPDevice correspondiente a un nombre de ruta de acceso del dispositivo si crea un objeto IMDSPDevice para cada almacenamiento de nivel superior. Esto está sujeto a cambios en el futuro y el recuento puede estar restringido a 1.

Valor devuelto

Si el método se ejecuta correctamente, devuelve S_OK. Si se produce un error en el método, devuelve los códigos de error de Windows Media Administrador de dispositivos.

Comentarios

Windows Media Administrador de dispositivos llama a este método cuando se inicia una aplicación o cuando un dispositivo compatible Plug and Play se conecta con el equipo.

Requisitos

Requisito Value
Plataforma de destino Windows
Encabezado mswmdm.h
Library Mssachlp.lib

Consulte también

Enumeración de dispositivos

Interfaz IMDServiceProvider2