AtaPortRegistryControllerKeyRead-Funktion (irb.h)

Artikel
02/07/2025

Die AtaPortRegistryControllerKeyRead Routine liest die Daten, die dem angegebenen Wertnamen unter dem Registrierungsschlüssel HKLM\CurrentControlSet\Services\<service name>\ControllerNzugeordnet sind, wobei N die Nummer des Controllers ist.

Hinweis Der ATA-Porttreiber und die ATA Miniport-Treibermodelle können in Zukunft geändert oder nicht verfügbar sein. Stattdessen empfehlen wir die Verwendung des Storport-Treibers und Storport Miniport Treibermodelle.

Syntax

BOOLEAN AtaPortRegistryControllerKeyRead(
  [in]            PVOID  ChannelExtension,
  [in]            UCHAR  ControllerNumber,
  [in]            PCHAR  ValueName,
  [in]            UCHAR  ValueType,
  [out, optional] PUCHAR Buffer,
                  PULONG BufferLength
);

Parameter

[in] ChannelExtension

Ein Zeiger auf die Kanalerweiterung.

[in] ControllerNumber

Enthält die Controllernummer.

[in] ValueName

Enthält den Namen des zu lesenden Registrierungswerts.

[in] ValueType

Gibt den Typ der Daten an, die im Registrierungswert enthalten sind. Diesem Parameter sollte einer der werte zugewiesen werden, die in der folgenden Tabelle angegeben sind.

Werttyp	Bedeutung
IDE_REG_DWORD	Ein numerischer 4-Byte-Wert.
IDE_REG_BINARY	Binäre Daten.
IDE_REG_SZ	Eine mit Null beendete Unicode-Zeichenfolge.

[out, optional] Buffer

Ein Zeiger auf den Puffer, in den die Ergebnisse kopiert werden sollen.

BufferLength

Ein Zeiger auf die Anzahl der zu kopierenden Daten. Wenn der Vorgang aufgrund eines unzureichenden Puffers fehlschlägt, wird der Speicherort, auf den Length verweist, auf die tatsächliche Länge der Daten in der Registrierung aktualisiert.

Rückgabewert

AtaPortRegistryControllerKeyRead gibt TRUE zurück, wenn der Vorgang erfolgreich ist. Andernfalls wird FALSE-zurückgegeben. Die AtaPortRegistryControllerKeyRead Routine gibt auch FALSE- zurück, wenn der Miniporttreiber sie nicht aus der richtigen Routine aufruft.

Bemerkungen

Der Puffer bei Buffer- muss mithilfe AtaPortRegistryAllocateBuffer-zugewiesen werden.

Der Miniporttreiber muss AtaPortRegistryControllerKeyRead- entweder in der AtaChannelInitRoutine Routine oder in der IdeHwControl Routine aufrufen. Es kann keine AtaPortRegistryControllerKeyRead- von einer anderen Routine aufrufen. Darüber hinaus kann der Miniporttreiber nur AtaPortRegistryControllerKeyRead- aus seiner IdeHwControl-Routine aufrufen, wenn die IdeHwControl Routine aufgerufen wurde und entweder StartChannel oder StopChann el im ControlAction Parameter einen Wert aufweist.

Anforderungen

Anforderung	Wert
Zielplattform-	Desktop
Header-	irb.h (include Ata.h, Irb.h)

Siehe auch

AtaChannelInitRoutine

AtaPortRegistryAllocateBuffer

IdeHwControl-

Freigeben über