Método IWDFDevice::CreateWdfFile (wudfddi.h)

[Advertencia: UMDF 2 es la versión más reciente de UMDF y sustituye a UMDF 1. Todos los controladores UMDF nuevos deben escribirse con UMDF 2. No se agregan nuevas características a UMDF 1 y hay compatibilidad limitada con UMDF 1 en versiones más recientes de Windows 10. Los controladores universales de Windows deben usar UMDF 2. Para obtener más información, consulta Introducción con UMDF.

El método CreateWdfFile crea un objeto de archivo para que un controlador lo use.

Sintaxis

HRESULT CreateWdfFile(
  [in, optional] LPCWSTR               pcwszFileName,
  [out]          IWDFDriverCreatedFile **ppFile
);

Parámetros

[in, optional] pcwszFileName

Puntero a una cadena terminada en NULL que contiene el nombre del archivo desde el que se va a crear un objeto de archivo. Este parámetro es opcional. El controlador puede pasar NULL si el controlador no tiene que crear el objeto de archivo a partir de un nombre de archivo. Si el controlador debe proporcionar un nombre, la cadena que el controlador pasa no debe contener ningún carácter separador de ruta de acceso ("/" o "\").

[out] ppFile

Puntero a un búfer que recibe un puntero a la interfaz IWDFDriverCreatedFile para el objeto de archivo creado por el controlador.

Valor devuelto

CreateWdfFile devuelve S_OK si la operación se realiza correctamente. De lo contrario, este método devuelve uno de los códigos de error definidos en Winerror.h.

Comentarios

Para obtener información sobre cuándo un controlador UMDF usa CreateWdfFile para controlar la E/S, vea Crear un objeto de archivo para controlar la E/S.

Para obtener información sobre cuándo un controlador UMDF puede usar CreateWdfFile para evitar un desequilibrio de creación y cierre de notificaciones a un controlador, consulte Prevención de un desequilibrio de creación y cierre de notificaciones en un controlador.

Requisitos

Requisito	Value
Finalización del soporte técnico	No disponible en UMDF 2.0 y versiones posteriores.
Plataforma de destino	Escritorio
Versión mínima de UMDF	1.5
Encabezado	wudfddi.h (incluya Wudfddi.h)
Archivo DLL	WUDFx.dll

Consulte también

IWDFDevice

IWDFDriverCreatedFile