Metodo IWDFDevice::CreateWdfFile (wudfddi.h)

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Nessuna nuova funzionalità viene aggiunta a UMDF 1 ed è disponibile un supporto limitato per UMDF 1 nelle versioni più recenti di Windows 10. I driver di Windows universali devono usare UMDF 2. Per altre informazioni, vedere Introduzione con UMDF.]

Il metodo CreateWdfFile crea un oggetto file da usare per un driver.

Sintassi

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

Parametri

[in, optional] pcwszFileName

Puntatore a una stringa con terminazione NULL contenente il nome del file da cui creare un oggetto file. Questo parametro è facoltativo e, Il driver può passare NULL se il driver non deve creare l'oggetto file da un nome file. Se il driver deve specificare un nome, la stringa che il driver passa non deve contenere caratteri separatori di percorso ("/" o "\").

[out] ppFile

Puntatore a un buffer che riceve un puntatore all'interfaccia IWDFDriverCreatedFile per l'oggetto file creato dal driver.

Valore restituito

CreateWdfFile restituisce S_OK se l'operazione ha esito positivo. In caso contrario, questo metodo restituisce uno dei codici di errore definiti in Winerror.h.

Commenti

Per informazioni su quando un driver UMDF usa CreateWdfFile per gestire I/O, vedere Creazione di un oggetto file per gestire I/O.

Per informazioni su quando un driver UMDF potrebbe usare CreateWdfFile per evitare uno squilibrio di creazione e chiusura delle notifiche a un driver, vedere Prevenzione di uno squilibrio di creazione e chiusura delle notifiche a un driver.

Requisiti

Vedi anche

IWDFDevice

IWDFDriverCreatedFile