Valutazione di un metodo di controllo senza argomenti di input

Per valutare in modo sincrono un metodo di controllo che non accetta argomenti di input, un driver per un dispositivo invia una richiesta di IOCTL_ACPI_EVAL_METHOD o una richiesta di IOCTL_ACPI_EVAL_METHOD_EX al dispositivo. La procedura generale per l'utilizzo di entrambe queste richieste è descritta in valutazione sincrona dei metodi di controllo ACPI. La differenza specifica tra l'uso di queste due richieste è la seguente:

• Se il metodo di controllo è un oggetto figlio immediato del dispositivo, il driver invia una richiesta di IOCTL_ACPI_EVAL_METHOD e fornisce una struttura di input ACPI_EVAL_INPUT_BUFFER.

• Se il metodo di controllo è un oggetto figlio nello spazio dei nomi ACPI del dispositivo, ma non è un oggetto figlio immediato del dispositivo, il driver invia una richiesta di IOCTL_ACPI_EVAL_METHOD_EX e fornisce una struttura ACPI_EVAL_INPUT_BUFFER_EX.

L'esempio funzione getAbcData fornita in questo argomento illustra come un driver per un dispositivo può usare una richiesta di IOCTL_ACPI_EVAL_METHOD per valutare un metodo di controllo denominato "ABCD" supportato dal dispositivo. Il metodo di controllo 'ABCD' è un elemento figlio immediato del dispositivo nello spazio dei nomi ACPI e non accetta argomenti di input o restituisce argomenti di output.

Se il metodo di controllo 'ABCD' non è un oggetto figlio immediato, le modifiche necessarie a questo codice di esempio sono le seguenti:

• Inviare una richiesta di IOCTL_ACPI_EVAL_METHOD_EX anziché una richiesta di IOCTL_ACPI_EVAL_METHOD.

• Fornire una struttura ACPI_EVAL_INPUT_BUFFER_EX anziché una struttura ACPI_EVAL_INPUT_BUFFER.

GetAbcData alloca innanzitutto una struttura ACPI_EVAL_INPUT_BUFFER inputBuffer e imposta il membro MethodNameAsUlong al nome del metodo di controllo e il membro Signature su ACPI_EVAL_INPUT_BUFFER_SIGNATURE.

    // Fill in the input data
    inputBuffer.MethodNameAsUlong = (ULONG) ('DCBA');
    inputBuffer.Signature = ACPI_EVAL_INPUT_BUFFER_SIGNATURE;

GetAbcData alloca anche una struttura ACPI_EVAL_OUTPUT_BUFFERoutputBuffer, ma non imposta alcun membro di outputBuffer.

GetAbcData quindi chiama una funzione fornita dal driver denominata SendDownStreamIrp che esegue le operazioni seguenti:

1. Chiama IoBuildDeviceIoControlRequest per compilare la richiesta.

2. Chiama IoCallDriver per inviare la richiesta nello stack dei dispositivi.

3. Attende che il gestore di I/O segnali il driver che i driver di livello inferiore hanno completato la richiesta.

SendDownStreamIrp restituisce dopo che il gestore di I/O segnala che i driver di livello inferiore hanno completato la richiesta. L'esempio di codice menzionato in precedenza esegue le operazioni seguenti:

1. Controlla lo stato della richiesta e restituisce senza ulteriore elaborazione se i driver di livello inferiore non hanno restituito STATUS_SUCCESS.

2. Controlla la validità degli argomenti di output. Affinché outputBuffer contenga dati di output validi, Signature deve essere impostata su ACPI_EVAL_OUTPUT_BUFFER_SIGNATURE e Count deve essere impostato su un valore maggiore di zero.

3. Elabora gli argomenti di output che il driver ACPI ha passato indietro al driver.

Anche se questo passaggio non è incluso nel codice di esempio, il driver deve anche chiamare IoCompleteRequest dopo l'elaborazione dei dati di output per completare la richiesta di IOCTL_ACPI_EVAL_METHOD in sospeso o IOCTL_ACPI_EVAL_METHOD richiesta inviata dal driver per valutare un metodo di controllo.

Le strutture di dati ACPI e le costanti utilizzate nell'esempio seguente sono definite in Acpioct.h.

NTSTATUS
GetAbcdData(
    IN PDEVICE_OBJECT   Pdo,
    OUT PULONG          ReturnStatus
    )
/*++

Routine Description:
    Evaluates the ABCD method on the device in the ACPI namespace referenced by Pdo

Parameters
    Pdo             - PDO for the device
    ReturnStatus    - Pointer to where the status data is placed

Return Value:
    NT Status of the operation

--*/
{
    ACPI_EVAL_INPUT_BUFFER  inputBuffer;
    ACPI_EVAL_OUTPUT_BUFFER outputBuffer;
    NTSTATUS                status;
    PACPI_METHOD_ARGUMENT   argument;

    .
    .

    ASSERT( ReturnStatus != NULL );
    *ReturnStatus = 0x0;

    // Fill in the input data
    inputBuffer.MethodNameAsUlong = (ULONG) ('DCBA');
    inputBuffer.Signature = ACPI_EVAL_INPUT_BUFFER_SIGNATURE;

    // Send the request along
    status = SendDownStreamIrp(
       Pdo,
       IOCTL_ACPI_EVAL_METHOD,
       &inputBuffer,
       sizeof(ACPI_EVAL_INPUT_BUFFER),
       &outputBuffer,
       sizeof(ACPI_EVAL_OUTPUT_BUFFER)
       );

    if (!NT_SUCCESS(status)) {
       return status;
    }

    // Verify the data
    if (outputBuffer != NULL) {
        if ( ( (PACPI_EVAL_OUTPUT_BUFFER) outputBuffer->Signature != 
            ACPI_EVAL_OUTPUT_BUFFER_SIGNATURE ||
            ( (PACPI_EVAL_OUTPUT_BUFFER) outputBuffer->Count == 0) {
            return STATUS_ACPI_INVALID_DATA;
        } 
}

    // Retrieve the output argument
    argument = outputBuffer.Argument;
 
// Process the output argument
 .
.
.
 
    return status;
}