Metodo IWDFIoRequest2::GetCreateParametersEx (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 GetCreateParametersEx recupera i parametri di creazione dei file associati a un file creato o aperto.

Sintassi

void GetCreateParametersEx(
  [out, optional] ULONG       *pOptions,
  [out, optional] USHORT      *pFileAttributes,
  [out, optional] USHORT      *pShareAccess,
  [out, optional] ACCESS_MASK *pDesiredAccess
);

Parametri

[out, optional] pOptions

Puntatore a una variabile allocata dal chiamante che riceve flag di bit che indicano le opzioni di creazione di file. Questi flag di bit denominati FILE_XXXX sono definiti in Wdm.h.

I 24 bit bassi della variabile indicano le opzioni da applicare durante la creazione o l'apertura del file. Per altre informazioni su questi bit, vedere la descrizione del parametro CreateOptions della funzione ZwCreateFile in modalità kernel.

L'alto otto bit della variabile indica le azioni da eseguire se il file non esiste o non esiste già. Per altre informazioni su questi bit, vedere la descrizione del parametro CreateDisposition di ZwCreateFile.

Questo parametro è facoltativo e può essere NULL.

[out, optional] pFileAttributes

Puntatore a una variabile allocata dal chiamante che riceve flag di bit che indicano gli attributi del file. Questi flag di bit FILE_ATTRIBUTE_XXXX denominati sono definiti in Wdm.h. Per altre informazioni su questi flag di bit, vedere la descrizione del parametro FileAttributes di ZwCreateFile.

Questo parametro è facoltativo e può essere NULL.

[out, optional] pShareAccess

Puntatore a una variabile allocata dal chiamante che riceve flag di bit che indicano le opzioni di condivisione file. Questi flag di bit denominati FILE_SHARE_XXXX sono definiti in Wdm.h. Per altre informazioni su questi flag di bit, vedere la descrizione del parametro ShareAccess di ZwCreateFile.

Questo parametro è facoltativo e può essere NULL.

[out, optional] pDesiredAccess

Puntatore a una struttura ACCESS_MASK allocata dal chiamante che specifica l'accesso richiesto al file. Per altre informazioni su questo parametro, vedere il parametro DesiredAccess di ZwCreateFile.

Questo parametro è facoltativo e può essere NULL.

Valore restituito

nessuno

Osservazioni

Dopo che il framework chiama la funzione di callback IQueueCallbackCreate::OnCreateFile, il driver può chiamare il metodo IWDFIoRequest::GetCreateParameters o il metodo IWDFIoRequest2::GetCreateParametersEx per ottenere i parametri di creazione del file.

Per altre informazioni, vedere Ottenere parametri per le richieste di I/O.

Esempio

Nell'esempio di codice seguente viene illustrato come una funzione di callback IQueueCallbackCreate::OnCreateFile può ottenere l'interfaccia IWDFIoRequest2 e quindi chiamare GetCreateParametersEx.

VOID
OnCreateFile(
    __in IWDFIoQueue* FxQueue,
    __in IWDFIoRequest* FxRequest,
    __in IWDFFile* FxFile
    )
{
    ULONG fileOptions;
    USHORT fileAttributes,
    USHORT shareAccess,
    ACCESS_MASK desiredAccess;
    ...
    CComQIPtr<IWDFIoRequest2> fxRequest2(FxRequest);
    fxRequest2->GetCreateParametersEx(&fileOptions
                                      &fileAttributes,
                                      &shareAccess,
                                      &desiredAccess);
    ...
}

Requisiti

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

Vedi anche

IQueueCallbackCreate::OnCreateFile

IWDFIoRequest2

IWDFIoRequest::GetCreateParameters