Método IWDFIoRequest2::GetCreateParametersEx (wudfddi.h)
[Aviso: UMDF 2 é a versão mais recente do UMDF e substitui UMDF 1. Todos os novos drivers UMDF devem ser gravados usando UMDF 2. Nenhum novo recurso está sendo adicionado ao UMDF 1 e há suporte limitado para UMDF 1 em versões mais recentes do Windows 10. Drivers universais do Windows devem usar UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]
O método GetCreateParametersEx recupera parâmetros de criação de arquivo associados a um arquivo que está sendo criado ou aberto.
Sintaxe
void GetCreateParametersEx(
[out, optional] ULONG *pOptions,
[out, optional] USHORT *pFileAttributes,
[out, optional] USHORT *pShareAccess,
[out, optional] ACCESS_MASK *pDesiredAccess
);
Parâmetros
[out, optional] pOptions
Um ponteiro para uma variável alocada pelo chamador que recebe sinalizadores de bits que indicam opções de criação de arquivo. Esses sinalizadores de bits nomeados FILE_XXXX são definidos em Wdm.h.
Os 24 bits baixos da variável indicam opções a serem aplicadas ao criar ou abrir o arquivo. Para obter mais informações sobre esses bits, consulte a descrição do parâmetro CreateOptions da função ZwCreateFile do modo kernel.
Os oito bits altos da variável indicam ações a serem executadas se o arquivo existir ou ainda não existir. Para obter mais informações sobre esses bits, consulte a descrição do parâmetro CreateDisposition de ZwCreateFile.
Esse parâmetro é opcional e pode ser NULL.
[out, optional] pFileAttributes
Um ponteiro para uma variável alocada pelo chamador que recebe sinalizadores de bits que indicam atributos de arquivo. Esses sinalizadores de bits nomeados FILE_ATTRIBUTE_XXXX são definidos em Wdm.h. Para obter mais informações sobre esses sinalizadores de bits, consulte a descrição do parâmetro FileAttributes de ZwCreateFile.
Esse parâmetro é opcional e pode ser NULL.
[out, optional] pShareAccess
Um ponteiro para uma variável alocada pelo chamador que recebe sinalizadores de bits que indicam opções de compartilhamento de arquivos. Esses sinalizadores de bits nomeados FILE_SHARE_XXXX são definidos em Wdm.h. Para obter mais informações sobre esses sinalizadores de bits, consulte a descrição do parâmetro ShareAccess de ZwCreateFile.
Esse parâmetro é opcional e pode ser NULL.
[out, optional] pDesiredAccess
Um ponteiro para uma estrutura de ACCESS_MASK alocada pelo chamador que especifica o acesso solicitado ao arquivo. Para obter mais informações sobre esse parâmetro, consulte o parâmetro DesiredAccess de ZwCreateFile.
Esse parâmetro é opcional e pode ser NULL.
Retornar valor
Nenhum
Comentários
Depois que a estrutura chama a função de retorno de chamada IQueueCallbackCreate::OnCreateFile de um driver, o driver pode chamar o método IWDFIoRequest::GetCreateParameters ou o método IWDFIoRequest2::GetCreateParametersEx para obter os parâmetros de criação do arquivo.
Para obter mais informações, consulte Obtendo parâmetros para solicitações de E/S.
Exemplos
O exemplo de código a seguir mostra como uma função de retorno de chamada IQueueCallbackCreate::OnCreateFile pode obter a interface IWDFIoRequest2 e chamar 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);
...
}
Requisitos
| Requisito | Valor |
|---|---|
| Fim do suporte | Indisponível no UMDF 2.0 e posterior. |
| Plataforma de Destino | Área de Trabalho |
| Versão mínima do UMDF | 1,9 |
| Cabeçalho | wudfddi.h (include Wudfddi.h) |
| DLL | WUDFx.dll |