Compartilhar via


função WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE (wdfiotarget.h)

[Aplica-se somente ao UMDF]

A função WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE inicializa a estrutura de WDF_IO_TARGET_OPEN_PARAMS de um driver para que o driver possa abrir um destino de E/S especificando um nome de arquivo.

Sintaxe

void WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE(
  [out]          PWDF_IO_TARGET_OPEN_PARAMS Params,
  [in, optional] PCUNICODE_STRING           FileName
);

Parâmetros

[out] Params

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

[in, optional] FileName

Um valor para o membro FileName da estrutura WDF_IO_TARGET_OPEN_PARAMS . A maioria dos drivers especifica NULL aqui, a menos que o destino inferior dê suporte ao Acesso ao Namespace do Dispositivo.

Retornar valor

Nenhum

Comentários

A função WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE zerar a estrutura de WDF_IO_TARGET_OPEN_PARAMS especificada e define seu membro Size . Ele também define o membro Type da estrutura como WdfIoTargetOpenLocalTargetByFile e define o membro FileName se o driver fornecer um nome de arquivo.

Um driver pode fechar explicitamente o destino de E/S chamando WdfIoTargetClose. Se o driver não fechar explicitamente o destino, a estrutura fechará o destino automaticamente quando o dispositivo for removido (um destino de E/S é, por padrão, pai do dispositivo).

Exemplos

O exemplo de código a seguir mostra como um driver UMDF pode abrir um destino local com um objeto de arquivo, conforme descrito em WDF_IO_TARGET_OPEN_TYPE:

WDF_OBJECT_ATTRIBUTES  ioTargetAttrib;
WDFIOTARGET  ioTarget;
WDF_IO_TARGET_OPEN_PARAMS  openParams;

//
// Create target
//
WDF_OBJECT_ATTRIBUTES_INIT_CONTEXT_TYPE(&ioTargetAttrib, TARGET_DEVICE_INFO);
status = WdfIoTargetCreate(device, &ioTargetAttrib, &ioTarget);
if (!NT_SUCCESS(status)) {
    return status;
}

//
// Open target
//
WDF_IO_TARGET_OPEN_PARAMS_INIT_OPEN_BY_FILE(&openParams, NULL);
status = WdfIoTargetOpen(ioTarget, &openParams);
if (!NT_SUCCESS(status)) {
    WdfObjectDelete(ioTarget);
    return status;
}

//
// create a request
//


//
// Format the request for the above target
//


//
// Send request to above target
//

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 8.1
Plataforma de Destino Universal
Versão mínima do UMDF 2,0
Cabeçalho wdfiotarget.h (inclua Wdf.h)
IRQL Qualquer nível

Confira também

WDF_IO_TARGET_OPEN_PARAMS

WDF_IO_TARGET_OPEN_TYPE