Metodo IWDFIoRequest::GetCreateParameters (wudfddi.h)

  • Articolo

[Avviso: UMDF 2 è la versione più recente di UMDF e sostituisce UMDF 1. Tutti i nuovi driver UMDF devono essere scritti usando UMDF 2. Non vengono aggiunte nuove funzionalità 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 info, vedi Introduzione con UMDF.]

Il metodo GetCreateParameters recupera i parametri della richiesta per una richiesta di tipo create.

Sintassi

void GetCreateParameters(
  [out, optional] ULONG  *pOptions,
  [out, optional] USHORT *pFileAttributes,
  [out, optional] USHORT *pShareAccess
);

Parametri

[out, optional] pOptions

Puntatore a una variabile che riceve una maschera di bit di flag che specifica le opzioni applicate durante la creazione o l'apertura del file associato alla richiesta e l'azione da eseguire se il file esiste già.

I 8 bit alti di questo parametro corrispondono al parametro CreateDisposition della funzione ZwCreateFile in modalità kernel. Questi 8 bit specificano l'azione da eseguire, a seconda che il file esista già. Si noti che questi valori di eliminazione differiscono dai valori usati nel parametro dwCreationDisposition della funzione CreateFile Win32.

I 24 bit bassi di questo parametro corrispondono al parametro CreateOptions di ZwCreateFile.

Questo parametro è facoltativo e, Il driver può passare NULL se il driver non richiede le informazioni.

[out, optional] pFileAttributes

Puntatore a una variabile che riceve una maschera di bit di flag di attributo applicata durante la creazione o l'apertura del file associato alla richiesta. Gli attributi specificati in modo esplicito vengono applicati solo quando il file viene creato, sostituito o, in alcune situazioni, sovrascritto. Per impostazione predefinita, viene specificato il flag di FILE_ATTRIBUTE_NORMAL singolo. Tuttavia, questo flag può essere sottoposto a override da qualsiasi altro flag o da una combinazione OR bit per bit di flag compatibili. La maschera di bit dei flag di attributo corrisponde al parametro FileAttributes di ZwCreateFile.

Questo parametro è facoltativo e, Il driver può passare NULL se il driver non richiede le informazioni.

[out, optional] pShareAccess

Puntatore a una variabile che riceve una maschera di bit di flag che specificano i diritti di accesso di condivisione richiesti per il file associato alla richiesta. Se la maschera di bit ricevuta è zero, viene richiesto l'accesso esclusivo. Per altre informazioni sull'accesso alla condivisione, vedere la descrizione del parametro ShareAccess di ZwCreateFile.

Questo parametro è facoltativo e, Il driver può passare NULL se il driver non richiede le informazioni.

Valore restituito

nessuno

Osservazioni

Anche se il driver può facoltativamente specificare NULL per ognuno dei parametri pOptions, pFileAttributes e pShareAccess , il driver deve specificare almeno un parametro non NULL per l'esecuzione corretta di GetCreateParameters .

Requisiti

Requisito Valore
Fine del supporto Non disponibile in UMDF 2.0 e versioni successive.
Piattaforma di destinazione Desktop
Versione UMDF minima 1.5
Intestazione wudfddi.h (include Wudfddi.h)
DLL WUDFx.dll

Vedi anche

IWDFIoRequest

ZwCreateFile