função WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME (wdfiotarget.h)

[Aplica-se a KMDF e UMDF]

A função WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME inicializa a estrutura de WDF_IO_TARGET_OPEN_PARAMS de um driver para que o driver possa abrir um destino de E/S especificando o nome do dispositivo, arquivo ou interface do dispositivo. Se o nome fornecido não existir, o sistema não tentará criá-lo.

Sintaxe

void WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME(
  [out] PWDF_IO_TARGET_OPEN_PARAMS Params,
  [in]  PCUNICODE_STRING           TargetDeviceName,
  [in]  ACCESS_MASK                DesiredAccess
);

Parâmetros

[out] Params

Um ponteiro para uma estrutura de WDF_IO_TARGET_OPEN_PARAMS alocada por driver, que a função inicializa.

[in] TargetDeviceName

Um valor para o membro TargetDeviceName da estrutura WDF_IO_TARGET_OPEN_PARAMS .

[in] DesiredAccess

Um valor para o membro DesiredAccess da estrutura WDF_IO_TARGET_OPEN_PARAMS .

Retornar valor

Nenhum

Comentários

Se TargetDeviceName especificar o nome de um arquivo que já existe, o sistema abrirá o arquivo existente. Se o arquivo não existir, a operação aberta falhará.

A estrutura WDF_IO_TARGET_OPEN_PARAMS é usada como entrada para o método WdfIoTargetOpen .

A função WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME inicializa os membros Size, Type, TargetDeviceName, DesiredAccess, CreateOptions e CreateDisposition da estrutura WDF_IO_TARGET_OPEN_PARAMS especificada.

KMDF A função WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME inicializa o membro CreateDisposition para FILE_OPEN.

UMDF A função WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME inicializa o membro CreateDisposition para OPEN_EXISTING.

Para obter mais informações sobre destinos de E/S, consulte Usando destinos de E/S.

Exemplos

Para obter um exemplo de código que usa WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_NAME, consulte WdfIoTargetOpen.

Requisitos

Confira também

WDF_IO_TARGET_OPEN_PARAMS

WDF_IO_TARGET_OPEN_PARAMS_INIT_CREATE_BY_NAME

WDF_IO_TARGET_OPEN_PARAMS_INIT_EXISTING_DEVICE

WdfIoTargetOpen