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 を返します。 それ以外の場合、ルーチンは適切なエラー コードを返します。 次の表は、可能な戻り状態コードを示しています。
リターン コード | 説明 |
---|---|
|
ハンドル パラメーターの値が無効であることを示します。 |
注釈
詳細については、「 ウォール クロック」および「リンク位置レジスタ」を参照してください。
要件
要件 | 値 |
---|---|
対象プラットフォーム | デスクトップ |
Header | hdaudio.h (Hdaudio.h を含む) |
IRQL | <=DISPATCH_LEVEL |