PGET_LINK_POSITION_REGISTER コールバック関数 (hdaudio.h)
GetLinkPositionRegister ルーチンは、DMA エンジンのリンク位置レジスタへのポインターを取得します。
GetLinkPositionRegister ルーチンの関数ポインター型は、次のように定義されます。
構文
PGET_LINK_POSITION_REGISTER PgetLinkPositionRegister;
NTSTATUS PgetLinkPositionRegister(
[in] PVOID _context,
[in] HANDLE Handle,
[out] PULONG *Position
)
{...}
パラメーター
[in] _context
HDAUDIO_BUS_INTERFACE、HDAUDIO_BUS_INTERFACE_V2、または HDAUDIO_BUS_INTERFACE_BDL 構造体の Context メンバーのコンテキスト値を指定します。
[in] Handle
DMA エンジンを識別するハンドル。 このハンドル値は、AllocateCaptureDmaEngine または AllocateRenderDmaEngine 以前の呼び出しから取得されました。
[out] Position
リンク位置レジスタへのポインターを取得します。 このパラメーターは、ルーチンがレジスタへのポインターを書き込む呼び出し元によって割り当てられた PULONG 変数を指します。 HD オーディオ バス ドライバーは、ファンクション ドライバーにアクセスできるシステム仮想アドレスにレジスタをマップします。
戻り値
呼び出しが成功した場合、GetLinkPositionRegister はSTATUS_SUCCESSを返します。 それ以外の場合、ルーチンは適切なエラー コードを返します。 次の表に、可能な戻り状態コードを示します。
| リターン コード | 形容 |
|---|---|
|
パラメーター値 ハンドルが無効であることを示します。 |
備考
詳細については、ウォール クロックおよびリンク位置レジスタを参照してください。
必要条件
| 要件 | 価値 |
|---|---|
| ターゲット プラットフォーム の | デスクトップ |
| ヘッダー | hdaudio.h (Hdaudio.h を含む) |
| IRQL | <=DISPATCH_LEVEL |
関連項目
AllocateCaptureDmaEngine の
AllocateRenderDmaEngine の