Método IWDFIoRequest::GetCreateParameters (wudfddi.h)

  • Artigo

[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. Os drivers universais do Windows devem usar o UMDF 2. Para obter mais informações, consulte Introdução com UMDF.]

O método GetCreateParameters recupera os parâmetros de solicitação para uma solicitação de tipo de criação.

Sintaxe

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

Parâmetros

[out, optional] pOptions

Um ponteiro para uma variável que recebe uma máscara de bits de sinalizadores que especificam as opções que são aplicadas ao criar ou abrir o arquivo associado à solicitação e a ação a ser tomada se o arquivo já existir.

Os 8 bits altos desse parâmetro correspondem ao parâmetro CreateDisposition da função ZwCreateFile do modo kernel. Esses 8 bits especificam a ação a ser tomada, dependendo se o arquivo já existe. Observe que esses valores de disposição diferem dos valores usados no parâmetro dwCreationDisposition da função CreateFile do Win32.

Os 24 bits baixos desse parâmetro correspondem ao parâmetro CreateOptions de ZwCreateFile.

Esse parâmetro é opcional. O driver poderá passar NULL se o driver não exigir as informações.

[out, optional] pFileAttributes

Um ponteiro para uma variável que recebe uma máscara de bits de sinalizadores de atributo que é aplicada ao criar ou abrir o arquivo associado à solicitação. Atributos especificados explicitamente são aplicados somente quando o arquivo é criado, substituído ou, em algumas situações, substituído. Por padrão, o único sinalizador de FILE_ATTRIBUTE_NORMAL é especificado. No entanto, esse sinalizador pode ser substituído por qualquer outro sinalizador ou por uma combinação OR bit a bit de sinalizadores compatíveis. A máscara de bits de sinalizadores de atributo corresponde ao parâmetro FileAttributes de ZwCreateFile.

Esse parâmetro é opcional. O driver poderá passar NULL se o driver não exigir as informações.

[out, optional] pShareAccess

Um ponteiro para uma variável que recebe uma máscara de bits de sinalizadores que especificam os direitos de acesso de compartilhamento solicitados para o arquivo associado à solicitação. Se a máscara de bits recebida for zero, o acesso exclusivo será solicitado. Para obter mais informações sobre o acesso ao compartilhamento, consulte a descrição do parâmetro ShareAccess de ZwCreateFile.

Esse parâmetro é opcional. O driver poderá passar NULL se o driver não exigir as informações.

Retornar valor

Nenhum

Comentários

Embora o driver possa, opcionalmente, especificar NULL para cada um dos parâmetros pOptions, pFileAttributes e pShareAccess , o driver deve especificar pelo menos um parâmetro não NULL para GetCreateParameters ser executado com êxito.

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.5
Cabeçalho wudfddi.h (inclua Wudfddi.h)
DLL WUDFx.dll

Confira também

IWDFIoRequest

ZwCreateFile