AtaPortRegistryChannelSubkeyRead-Funktion (irb.h)

Artikel
02/26/2024

Die AtaPortRegistryChannelSubKeyRead-Routine liest die Daten, die dem angegebenen Wertnamen unter dem Registrierungsschlüssel HKLM\CurrentControlSet\Services\<service name>\ControllerN\ChannelMzugeordnet sind, wobei N die Nummer des Controllers und M die Nummer des Kanals ist.

Hinweis Die Modelle ATA-Porttreiber und ATA-Miniporttreiber sind möglicherweise geändert oder in Zukunft nicht mehr verfügbar. Stattdessen wird empfohlen, die Modelle Storport-Treiber und Storport-Miniporttreiber zu verwenden.

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 Member sollte einer der in der folgenden Tabelle angegebenen Werte zugewiesen werden.

Wert	Bedeutung
IDE_REG_DWORD	Ein numerischer Wert mit 4 Byte.
IDE_REG_BINARY	Binärdaten.
IDE_REG_SZ	Ein NULL-terminiertes. Unicode-Zeichenfolge.

[out, optional] Buffer

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

BufferLength

Ein Zeiger auf die Anzahl der zu kopierenden Datenbytes. Wenn der Vorgang fehlschlägt, wird der Speicherort, auf den durch Length verwiesen wird, 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 ihn nicht aus der richtigen Routine aufruft.

Hinweise

Der Puffer, auf den von Buffer verwiesen wird, muss mithilfe von AtaPortRegistryAllocateBuffer zugeordnet werden.

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

Anforderungen

Anforderung	Wert
Zielplattform	Desktop
Kopfzeile	irb.h (einschließlich Ata.h, Irb.h)

Weitere Informationen

AtaChannelInitRoutine

AtaPortRegistryAllocateBuffer

AtaPortRegistryChannelSubKeyWrite

IdeHwControl

Freigeben über