AtaPortRegistryChannelSubkeyRead-Funktion (irb.h)

Artikel
02/07/2025

Die AtaPortRegistryChannelSubKeyRead Routine liest die Daten vor, die dem angegebenen Wertnamen unter dem Registrierungsschlüssel HKLM\CurrentControlSet\Services\<service name>\ControllerN\ChannelMzugeordnet sind, wobei N die Nummer des Controllers ist und M die Nummer des Kanals 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 AtaPortRegistryChannelSubkeyRead(
  [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 Registrierungswerts, aus dem gelesen werden soll.

[in] ValueType

Gibt den Datentyp an, der im Registrierungswert enthalten ist. Diesem Element sollte einer der werte zugewiesen werden, die in der folgenden Tabelle angegeben sind.

Wert	Bedeutung
IDE_REG_DWORD	Ein numerischer 4-Byte-Wert.
IDE_REG_BINARY	Binäre Daten.
IDE_REG_SZ	Ein null-beendeter Wert. Unicode-Zeichenfolge.

[out, optional] Buffer

Ein Zeiger auf den Zielpuffer, in dem die aus der Registrierung gelesenen Daten geschrieben werden.

BufferLength

Ein Zeiger auf die Anzahl der zu kopierenden Daten. Wenn der Vorgang fehlschlägt, wird der Speicherort, auf den Length verweist, auf die Länge der Daten aktualisiert, die erfolgreich aus der Registrierung kopiert wurden.

Rückgabewert

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

Bemerkungen

Der Puffer, auf den Buffer verweist, muss mithilfe AtaPortRegistryAllocateBuffer-zugewiesen werden.

Der Miniporttreiber muss AtaPortRegistryChannelSubKeyRead- entweder während der AtaChannelInitRoutine Routine oder der IdeHwControl Routine aufrufen, oder es wird FALSE-zurückgegeben. Darüber hinaus kann der Miniporttreiber nur AtaPortRegistryChannelSubKeyRead- aus seiner IdeHwControl--Routine aufrufen, wenn seine IdeHwControl--Routine aufgerufen wurde und entweder StartChannel oder StopChann el im ControlAction Parameter verwendet wurde.