FSCTL_GET_WOF_VERSION código de controle

O FSCTL_GET_WOF_VERSION código de controle de E/S (IOCTL) é usado para consultar a versão do driver usada para dar suporte a um provedor específico.

Para executar essa operação, chame FltFsControlFile ou ZwFsControlFile com os parâmetros a seguir.

BOOL 
   WINAPI 
   DeviceIoControl( (HANDLE)       hDevice,         // handle to device
                    (DWORD)        FSCTL_GET_WOF_VERSION, // dwIoControlCode
                    (LPDWORD)      lpInBuffer,      // input buffer
                    (DWORD)        nInBufferSize,   // size of input buffer
                    (LPDWORD)      lpOutBuffer,     // output buffer
                    (DWORD)        nOutBufferSize,  // size of output buffer
                    (LPDWORD)      lpBytesReturned, // number of bytes returned
                    (LPOVERLAPPED) lpOverlapped );  // OVERLAPPED structure

Parâmetros

• hDevice [in]: um identificador para o dispositivo. Para obter um identificador de dispositivo, chame a função CreateFile ou a API semelhante.

• dwIoControlCode [in]: o código de controle da operação. Use FSCTL_GET_WOF_VERSION para esta operação.

• lpInBuffer: o buffer de entrada para a operação. Esse é um ponteiro para uma estrutura de WOF_EXTERNAL_INFO .

• nInBufferSize [in]: o tamanho, em bytes, do buffer de entrada. Deve ser sizeof(WOF_EXTERNAL_INFO).

• lpOutBuffer [out]: o buffer de saída para a operação. Esse é um ponteiro para uma estrutura de WOF_VERSION_INFO .

• nOutBufferSize [in]: o tamanho, em bytes, do buffer de saída. Deve ser sizeof(WOF_VERSION_INFO).

• lpBytesReturned [out]: um ponteiro para uma variável que recebe o tamanho dos dados armazenados no buffer de saída, em bytes.

  Se o buffer de saída for muito pequeno, a chamada falhará, GetLastError retornará ERROR_INSUFFICIENT_BUFFER e lpBytesReturned será zero.

  Se lpOverlapped for NULL, lpBytesReturned não poderá ser NULL. Mesmo quando uma operação não retorna dados de saída e lpOutBuffer for NULL, DeviceIoControl usará lpBytesReturned. Após essa operação, o valor de lpBytesReturned não terá sentido.

  Se lpOverlapped não for NULL, lpBytesReturned poderá ser NULL. Se esse parâmetro não for NULL e a operação retornar dados, lpBytesReturned não terá sentido até que a operação sobreposta seja concluída. Para recuperar o número de bytes retornados, chame GetOverlappedResult. Se o parâmetro hDevice estiver associado a uma porta de conclusão de E/S, você poderá recuperar o número de bytes retornados chamando GetQueuedCompletionStatus.

• lpOverlapped [in]: um ponteiro para uma estrutura OVERLAPPED .

  Se hDevice tiver sido aberto sem especificar FILE_FLAG_OVERLAPPED, lpOverlapped será ignorado.

  Se hDevice tiver sido aberto com o sinalizador FILE_FLAG_OVERLAPPED, a operação será executada como uma operação sobreposta (assíncrona). Nesse caso, lpOverlapped deve apontar para uma estrutura OVERLAPPED válida que contenha um identificador para um objeto de evento. Caso contrário, a função falhará de maneiras imprevisíveis.

  Em operações sobrepostas, DeviceIoControl retorna imediatamente e o objeto do evento é sinalizado quando a operação é concluída. Caso contrário, a função não será retornada até que a operação seja concluída ou ocorra um erro.

Bloco de status

Se a operação for concluída com êxito, DeviceIoControl retornará um valor diferente de zero.

Se a operação falhar ou estiver pendente, DeviceIoControl retornará zero. Para obter informações de erro estendidas, chame GetLastError.

Requisitos